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_00601] لم يُستورد النص بعدUpstream: RS_SHWA_00016
class Event final {...};
Die Spezifikation definiert diesen Klassentyp mit der gezeigten Schnittstelle.
يزامن التطبيقات مع اكتمال مهام مسرّع الأجهزة المرتبطة أو التابعة.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: ca0070588ff8المصدرأسئلة مفتوحة (2)
مترجم من الدليل الألمانيمُولَّد بالذكاء الاصطناعيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
يزامن التطبيقات مع اكتمال مهام مسرّع الأجهزة المرتبطة أو التابعة.
تُستخدم الفئة ara::shwa::Event للمزامنة مع اكتمال مهام مسرّع الأجهزة في الوحدة shwa[AP_SWS_SHWA_00604]. وبعد الإنشاء المصنعي الآمن خيطيًا عبر Create()[AP_SWS_SHWA_00602]، يتم الانتظار بشكل حاصر أو محدد بزمن عبر دوال غير آمنة خيطيًا مثل Wait() أو WaitFor(). وإذا حدث خطأ أثناء تنفيذ المهمة، فلن تُطبَّق دلالات التراجع (Rollback)، ولذلك تُعتبر البيانات المستخدمة معدلة عن غير قصد [AP_SWS_SHWA_00604].
السياق
تعمل الفئة ara::shwa::Event داخل الوحدة shwa كعنصر مزامنة مركزي لمهام مسرّع الأجهزة. وتتمثل مسؤوليتها الرئيسية في المزامنة مع اكتمال المهام المرتبطة أو التابعة [AP_SWS_SHWA_00604]. وتتمثل أطراف التفاعل في خيوط جانب المُستدعي ومكونات التطبيق التي تنسق عمليات المسرّع غير المتزامنة. تفسير: بما أن الواجهة تزامن اكتمال المهام، فمن المرجح أن يغلف كائن Event واحد إشارات التنفيذ والمزامنة الخاصة بعملية تنفيذ عتادية محددة. سؤال Q-b4aa1debd356c45c (مفتوح)
دورة الحياة
تُنشأ مثيلات ara::shwa::Event عبر دالة المصنع الثابتة Create()، والتي تُرجع ara::core::Result<Event>[AP_SWS_SHWA_00602]. مسار الإنشاء هذا آمن خيطيًا (thread-safe) ولا يطلق استثناءات (noexcept، exception safe) [AP_SWS_SHWA_00602]. وبعد الإنشاء، يكون الكائن في حالة التشغيل النشطة ويتيح الاستعلام عن التبعيات بالإضافة إلى عمليات المزامنة.
فيما يتعلق بالتزامن، يجب على مكونات التطبيق مراعاة أن جميع دوال المثيل بالإضافة إلى استدعاءات المزامنة محددة صراحة على أنها غير آمنة خيطيًا (not thread-safe) [AP_SWS_SHWA_00603]، [AP_SWS_SHWA_00604]، [AP_SWS_SHWA_00605]، [AP_SWS_SHWA_00606]. وبالتالي، يتطلب الوصول المتزامن لخيوط متعددة إلى مثيل الحدث نفسه أو إلى قوائم الأحداث المشتركة مزامنة خارجية. ويتم تدمير الكائن عبر دورة حياة C++ العادية؛ ولا توجد دالة إغلاق أو تحرير صريحة في الواجهة.
مسار الاستخدام
ينقسم المسار العادي للمزامنة إلى إنشاء الكائن، والفحص الاختياري للتبعيات، والانتظار الفعلي للتنفيذ:
إنشاء المثيل: يستدعي المُستدعي Create() ويفحص الـ ara::core::Result المُستلم للتأكد من النجاح [AP_SWS_SHWA_00602].
الاستعلام عن التبعيات: عبر GetWaitList()، يمكن قراءة قائمة الأحداث التابعة كـ ara::core::Vector<Event>[AP_SWS_SHWA_00603]. من المفترض أن يعمل GetWaitList() كفحص للمهام السابقة التي يعتمد الحدث داخليًا على اكتمالها. سؤال Q-ed01dc595c23ce28 (مفتوح)
تنفيذ المزامنة: تتوفر ثلاثة خيارات للمزامنة:
الانتظار القائم على المثيل عبر Wait() يحصر حتى اكتمال المهام المرتبطة بالحدث [AP_SWS_SHWA_00604].
الانتظار الثابت لمجموعة من الأحداث عبر Wait(eventList) يزامن مع مجموعة كاملة من كائنات Event[AP_SWS_SHWA_00605].
الانتظار الثابت المحدد بزمن عبر WaitFor(ms) يحدد الانتظار بمدة معينة بالمللي ثانية [AP_SWS_SHWA_00606].
يستند هذا الدليل حصريًا إلى مواصفة الوحدة shwa للإصدار R25-11.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 96b8bb2a77c0المصدرأسئلة مفتوحة (2)
مترجم من الدليل الألمانيمُولَّد بالذكاء الاصطناعيgemini-3.8-flash-medium · 2026-10-14
توفير آليات التزامن والانتظار لمتابعة واكتمال مهام تسريع العتاد.
تُستخدم هذه الفئة لمزامنة واكتمال مهام تسريع العتاد المشترك عبر توفير آليات إنشاء الأحداث وانتظار تنفيذها [AP_SWS_SHWA_00602]. تتيح للمستدعي انتظار حدث مفرد أو مجموعة أحداث محددة بمهلة زمنية أو غير محددة [AP_SWS_SHWA_00606]. ويُعد التعامل مع الكائن بعد إنشائه غير آمن عبر الخيوط المتعددة، مع عدم وجود ضمانات للتراجع عن تغييرات البيانات عند فشل المهام.
السياق والمسؤولية
تمثل الفئة ara::shwa::Event في منصة AUTOSAR Adaptive (ضمن حزمة shwa المخصصة لتسريع العتاد المشترك) آلية التزامن الأساسية لتتبع واكتمال المهام المرتبطة بالعتاد ومزامنة العمليات غير المتزامنة. يتفاعل التطبيق مع هذه الفئة لإنشاء كائنات الأحداث، واسترجاع قوائم الأحداث التابعة، وحظر التنفيذ أو تعليقه مؤقتًا إلى حين اكتمال المهام التابعة [AP_SWS_SHWA_00602]. على الأرجح يقتصر دور هذا الكائن على إدارة إشارات التزامن بين منطق التطبيق ومهام المعالجة الموزعة على العتاد المسرّع، دون حمل بيانات حمولة وظيفية بذاته. سؤال (مفتوح)
دورة الحياة والتعامل مع الخيوط
تبدأ دورة حياة الكائن باستدعاء دالة المصنع الساكنة Create() التي تُرجع كائن الحدث مغلفًا في ara::core::Result<Event>[AP_SWS_SHWA_00602]. تتميز هذه الدالة بأنها آمنة للاستخدام المتزامن عبر الخيوط (thread-safe) وخالية من الاستثناءات (exception safe)، كما تدعم دلالات التراجع (rollback semantics) في حال الإخفاق. وبمجرد إنشاء كائن الحدث، فإن جميع العمليات اللاحقة على المثيل – مثل استدعاء GetWaitList() أو دوال المزامنة – تصبح غير آمنة للاستخدام متعدد الخيوط (not thread-safe) [AP_SWS_SHWA_00603]، [AP_SWS_SHWA_00604]. ولذلك يجب على المستدعي حماية الكائن عند مشاركته بين خيوط متعددة لضمان سلامة التنفيذ.
الإنشاء: توليد كائن الحدث عبر دالة المصنع Create() والتحقق من النتيجة [AP_SWS_SHWA_00602].
استعلام التبعيات: استرجاع قائمة الأحداث الواجب انتظارها قبل المتابعة باستخدام GetWaitList() إذا كانت هناك مهام سابقة مرتبطة بالحدث [AP_SWS_SHWA_00603].
المزامنة: استدعاء دالة المزامنة Wait() لتعليق الخيط حتى اكتمال الحدث الحالي [AP_SWS_SHWA_00604]، أو المزامنة الجماعية على قائمة متجهات للأحداث عبر Wait(eventList)[AP_SWS_SHWA_00605]. في حال الرغبة في تفادي التعليق غير المحدود، يمكن استخدام WaitFor(ms) لتحديد مهلة زمنية بالمللي ثانية [AP_SWS_SHWA_00606].
تستخدم جميع واجهات الفئة النمط الخالي من الاستثناءات بإرجاع ara::core::Result. يُرجَّح أن حدوث خطأ أثناء تنفيذ المهام المرتبطة بالحدث يترك البيانات المستخدمة في حالة تغيير غير مقصودة، حيث لا توفر عمليات الانتظار دلالات التراجع (no rollback semantics) [AP_SWS_SHWA_00604]، [AP_SWS_SHWA_00605]. تشمل رموز الأخطاء المحددة ما يلي:
ShwaErrorCode::kEventInvalidOperation: يقع عند إجراء عملية انتظار غير صالحة أو غير متوافقة مع الحالة الحالية للحدث [AP_SWS_SHWA_00603]، [AP_SWS_SHWA_00604].
Synchronisiert gemäß der Signatur auf den Abschluss assoziierter oder abhängiger Aufgaben; die zeitbegrenzte Variante begrenzt das Warten.
Scope
class ara::shwa::Event
Thread Safety
not thread-safe no_rollback_semantics ShwaErrorCode::k Runtime General runtime error. The data used within failed task execution should be considered as changed in unintended way no_rollback_semantics ShwaErrorCode::kTask ExecutionFailure Error during task execution. The data used within failed task execution should be considered as changed in unintended way no_rollback_semantics
Exception Safety
exception safe
Errors
ShwaErrorCode::kEvent InvalidOperation Error related to events (e.g., invalid wait on event)
Request a governed re-review of this record. The record is not changed immediately.
Synchronisiert gemäß der Signatur auf den Abschluss assoziierter oder abhängiger Aufgaben; die zeitbegrenzte Variante begrenzt das Warten.
Scope
class ara::shwa::Event
Thread Safety
not thread-safe no_rollback_semantics ShwaErrorCode::k Runtime General runtime error. The data used within failed task execution should be considered as changed in unintended way no_rollback_semantics ShwaErrorCode::kTask ExecutionFailure Error during task execution. The data used within failed task execution should be considered as changed in unintended way no_rollback_semantics
Exception Safety
exception safe
Errors
ShwaErrorCode::kEvent InvalidOperation Error related to events (e.g., invalid wait on event)
Request a governed re-review of this record. The record is not changed immediately.
Synchronisiert gemäß der Signatur auf den Abschluss assoziierter oder abhängiger Aufgaben; die zeitbegrenzte Variante begrenzt das Warten.
Scope
class ara::shwa::Event
Thread Safety
not thread-safe rollback_semantics ShwaErrorCode::k Runtime General runtime error. The data used within failed task execution should be considered as changed in unintended way no_rollback_semantics
Exception Safety
exception safe
Errors
ShwaErrorCode::kEvent InvalidOperation Error related to events (e.g., invalid wait on event) no_rollback_semantics ShwaErrorCode::kTask ExecutionFailure Error during task execution. The data used within failed task execution should be considered as changed in unintended way no_rollback_semantics ShwaErrorCode::kTimed Out Task execution timed-out. The data used within failed task execution should be considered as changed in unintended way
Request a governed re-review of this record. The record is not changed immediately.
gemini-3.8-flash-low· 2026-10-13 · الأصل الألماني