DEENESPTFRRUARHIKOZHNL

فئة ara::shwa::TaskHandler

Diese Seite wurde vollständig KI-generiert auf Basis von SWS Safe Hardware Acceleration (R25-11) — kein offizieller AUTOSAR-Text und keine automatisch extrahierte API-Seite wie die übrigen Module. Als Interpretation gekennzeichnete Aussagen sind Schlussfolgerungen aus den Quellen.

[AP_SWS_SHWA_01201] لم يُستورد النص بعد Upstream: RS_SHWA_00001

class TaskHandler final {...};

Die Spezifikation definiert diesen Klassentyp mit der gezeigten Schnittstelle.

Header-Datei#include "ara/shwa/task_handler.h"
Scopenamespace ara::shwa

دليل المستخدممولَّد بالذكاء الاصطناعي

يتيح إنشاء مهام حسابية فردية ومتوازية وإرسالها إلى أجهزة التسريع.
مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 6d7c7c77c2a9 المصدر أسئلة مفتوحة (2)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

يتيح إنشاء مهام حسابية فردية ومتوازية وإرسالها إلى أجهزة التسريع.

يُستخدم الصنف ara::shwa::TaskHandler لتنفيذ المهام على عتاد التسريع عبر عمليات الإرسال إلى قائمة الانتظار [AP_SWS_SHWA_01203]. تُنشأ النسخ الجديدة بأمان خيطي عبر دالة المصنع الثابتة Create()، والتي تُرجع الأخطاء في ara::core::Result [AP_SWS_SHWA_01202]. وعبر SingleTask وParallelFor، يمكن نقل خطوات حسابية فردية أو متوازية البيانات إلى الجهاز الهدف. وفي حين أن إنشاء النسخ آمن خيطيًا، فإن عمليات إرسال المهام ليست آمنة خيطيًا وتتطلب مزامنة خارجية عند الوصول المتوازي.

السياق

يعد الصنف ara::shwa::TaskHandler كصنف نهائي (final) جزءًا من وحدة تسريع العتاد (shwa) ضمن AUTOSAR Adaptive Platform. وهو يعمل كواجهة مركزية لنقل مهام الحساب وتنفيذها على جهاز هدف محدد (Device). وضمن بنية البرمجيات، يتولى الصنف دور الوسيط بين المكون البرمجي المُطبِّق وبنية التنفيذ التحتية الأساسية.

يتم التفاعل أساسًا بين طرفي نظام: التطبيق المستدعي ومسرّع العتاد المحدد أو قائمة انتظار المهام الخاصة به. تُستلم العمليات الحسابية المحددة من جانب التطبيق عبر واجهات ara::shwa::TaskHandler وتُمرر كإرساليات إلى قائمة الانتظار الخاصة بالجهاز [AP_SWS_SHWA_01203]. يتيح ذلك إنجاز كل من الخطوات الحسابية الفردية وأنماط المعالجة متوازية البيانات [AP_SWS_SHWA_01204]. تفسير: يُرجَّح أن يغلّف الصنف قوائم الانتظار الخاصة بالجهاز، بحيث تتمكن مكونات التطبيق من التحكم في موارد المسرّع دون الارتباط بالتفاصيل اللصيقة بالعتاد. سؤال (مفتوح)

دورة الحياة

تُدار دورة حياة كائن من ara::shwa::TaskHandler عبر نمط مصنع صارم. يتم إنشاء النسخ حصريًا عبر دالة المصنع الثابتة Create() [AP_SWS_SHWA_01202]. ونظرًا لأن الصنف معلن كـ final، فإن التخصيص عبر الوراثة مستبعد. يُعاد الكائن المُنشأ مغلفًا في ara::core::Result<TaskHandler>، مما يتطلب فحص نجاح التهيئة صراحة [AP_SWS_SHWA_01202].

فيما يتعلق بالتزامن وأمان الخيوط، يتمتع الصنف بخصائص متباينة:

  • إنشاء النسخ: استدعاء الدالة الثابتة Create() آمن خيطيًا (thread-safe) [AP_SWS_SHWA_01202]. وبذلك يمكن لعدة خيوط إنشاء كائنات معالج جديدة بشكل متزامن عبر مسار المصنع.
  • إرسال المهام: حُددت الدوال المخصصة لنقل أوامر العمل، SingleTask [AP_SWS_SHWA_01203] وParallelFor [AP_SWS_SHWA_01204]، صراحةً على أنها غير آمنة خيطيًا (not thread-safe). وبالتالي، لا يجوز استدعاء نسخة فردية من TaskHandler من عدة خيوط في الوقت نفسه دون تنسيق؛ وتقع مسؤولية المزامنة على عاتق المستدعي.
  • أمان الاستثناءات: أُعلن عن جميع دوال الواجهة كـ noexcept وتضمن أمان الاستثناءات (exception safe) [AP_SWS_SHWA_01202]، [AP_SWS_SHWA_01203]، [AP_SWS_SHWA_01204]. ومع Create() تنطبق بالإضافة إلى ذلك دلالات التراجع (rollback_semantics) في حال إخفاق التهيئة [AP_SWS_SHWA_01202].

تبقى علاقات الملكية لدى المكون المُطبِّق، الذي يحتفظ بالنسخة ويدمرها بمجرد عدم الحاجة إلى مزيد من إرساليات قائمة الانتظار.

مسار الاستخدام

ينقسم المسار النموذجي إلى مراحل الإنشاء وتكوين الأمر ونقل المهام. يطلب التطبيق أولاً نسخة جديدة عبر ara::shwa::TaskHandler::Create() [AP_SWS_SHWA_01202]. وبعد التحقق الناجح من ara::core::Result، يصبح الكائن جاهزًا لأوامر العمل.

بعد ذلك، يقرر التطبيق طريقة النقل المناسبة بناءً على نمط المعالجة:

  • بالنسبة للمهام الحسابية الفردية، يتم استدعاء SingleTask(cfg)، مما يدرج دالة المهمة المُمرَّرة كمعامل في قائمة انتظار الجهاز الهدف المحدد [AP_SWS_SHWA_01203].
  • بالنسبة لأنماط المعالجة متوازية البيانات، يتوفر قالب الدالة ParallelFor(bufferSize, cfg) [AP_SWS_SHWA_01204]. وهنا، يُمرَّر حجم المخزن المؤقت (bufferSize) بالإضافة إلى التكوين، وذلك للتحكم في التنفيذ المتوازي عبر عدة عناصر بيانات على جهاز المسرّع.

تفسير: يُرجَّح أن يمثل معامل القالب T دالة قابلة للاستدعاء، أو دالة لامبدا، أو تكوين مهام مطابق يغلف منطق الحساب المراد تنفيذه على الجهاز. سؤال Q-2fca8604440b44e9 (مفتوح)

تسلسل تقديم المهام باستخدام TaskHandlerApplicationTaskHandlerDevice-QueueUse Case: InstanziierungCreate()ara::core::Result<TaskHandler>Use Case: تنفيذ المهمةaltEinzelne AufgabeSingleTask(cfg)Queue-EinreichungParallele SchleifeParallelFor(bufferSize, cfg)Queue-Einreichung (Parallel)

مخطط تسلسل: سلسلة التفاعل من إنشاء النسخة حتى إرسال المهام إلى قائمة انتظار الجهاز. المصادر: [AP_SWS_SHWA_01202]، [AP_SWS_SHWA_01203]، [AP_SWS_SHWA_01204]

سيناريوهات الأخطاء

تتبع معالجة الأخطاء في ara::shwa::TaskHandler النموذج الخالي من الاستثناءات (noexcept) الخاص بـ Adaptive Platform.

تحدث حالات الأخطاء بصفة خاصة أثناء إنشاء النسخ:

  • تبلغ دالة المصنع Create() عن حالات الإخفاق عبر قناة الأخطاء في القيمة المُرجعة ara::core::Result [AP_SWS_SHWA_01202].
  • عُرِّف ShwaErrorCode::kRuntime كمحدد خطأ فعلي يشير إلى أخطاء وقت التشغيل العامة أثناء إنشاء الكائن [AP_SWS_SHWA_01202]. وتضمن دلالات التراجع المحددة عدم نشوء حالات مهيأة جزئيًا أو تسريبات في الموارد عند حدوث إخفاق [AP_SWS_SHWA_01202].

لا تُرجع الاستدعاءات SingleTask [AP_SWS_SHWA_01203] وParallelFor [AP_SWS_SHWA_01204] أي قيمة مُرجعة (void) ولا تطلق أي استثناءات. لذا يجب على جهات الاستدعاء التأكد من أن نسخة المعالج صالحة وأن عمليات الوصول من خيوط متزامنة تخضع للمزامنة خارجيًا.

تم إنشاء هذا النص بواسطة ذكاء اصطناعي بناءً على مواصفة AUTOSAR R25-11.

خريطة الأعضاء

الدوال الأعضاء

3
CreateParallelForSingleTask

عرض التفاصيل

اختر عنصرًا من المخطط.

الدوال الأعضاء

Create دالة

Erzeugt beziehungsweise liefert das in der Signatur beschriebene Objekt oder Ergebnis über den angegebenen Factory-Pfad.

static ara::core::Result< TaskHandler > Create () noexcept;
ParallelFor دالة

Führt die übergebene Task-Funktion innerhalb einer Queue-Einreichung auf dem ausgewählten Device aus.

template <typename T> void ParallelFor (std::size_t bufferSize, T cfg) noexcept;
SingleTask دالة

Führt die übergebene Task-Funktion innerhalb einer Queue-Einreichung auf dem ausgewählten Device aus.

template <typename T> void SingleTask (T cfg) noexcept;

التفاصيل

دالة Create [AP_SWS_SHWA_01202] Upstream: RS_SHWA_00001, RS_SHWA_00007

static ara::core::Result< TaskHandler > Create () noexcept;

Erzeugt beziehungsweise liefert das in der Signatur beschriebene Objekt oder Ergebnis über den angegebenen Factory-Pfad.

Scopeclass ara::shwa::TaskHandler
Thread Safetythread-safe rollback_semantics
Exception Safetyexception safe
ErrorsShwaErrorCode::k Runtime General runtime error

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/AP_SWS_SHWA_01202
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_SHWA_01202@rel:R25-11#c4e33c38
Content hash
c4e33c38
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_SafeHardwareAcceleration.pdf#nameddest=AP_SWS_SHWA_01202
Status: valid/unmigrated Version: rel:R25-11#a001527a Versionshistorie & Revisions (1 transition)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/AP_SWS_SHWA_01202@rel:R25-11#a001527a
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

دالة ParallelFor [AP_SWS_SHWA_01204] Upstream: RS_SHWA_00001

template <typename T> void ParallelFor (std::size_t bufferSize, T cfg) noexcept;

Führt die übergebene Task-Funktion innerhalb einer Queue-Einreichung auf dem ausgewählten Device aus.

Scopeclass ara::shwa::TaskHandler
Thread Safetynot thread-safe
Exception Safetyexception safe

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/AP_SWS_SHWA_01204
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_SHWA_01204@rel:R25-11#8e982a61
Content hash
8e982a61
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_SafeHardwareAcceleration.pdf#nameddest=AP_SWS_SHWA_01204
Status: valid/unmigrated Version: rel:R25-11#1ff0ddef Versionshistorie & Revisions (1 transition)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/AP_SWS_SHWA_01204@rel:R25-11#1ff0ddef
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

دالة SingleTask [AP_SWS_SHWA_01203] Upstream: RS_SHWA_00001

template <typename T> void SingleTask (T cfg) noexcept;

Führt die übergebene Task-Funktion innerhalb einer Queue-Einreichung auf dem ausgewählten Device aus.

Scopeclass ara::shwa::TaskHandler
Thread Safetynot thread-safe
Exception Safetyexception safe

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/AP_SWS_SHWA_01203
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_SHWA_01203@rel:R25-11#2744818e
Content hash
2744818e
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_SafeHardwareAcceleration.pdf#nameddest=AP_SWS_SHWA_01203
Status: valid/unmigrated Version: rel:R25-11#2c1013ce Versionshistorie & Revisions (1 transition)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/AP_SWS_SHWA_01203@rel:R25-11#2c1013ce
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill