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_00901] لم يُستورد النص بعدUpstream: RS_SHWA_00001
class Queue final {...};
Die Spezifikation definiert diesen Klassentyp mit der gezeigten Schnittstelle.
تُستخدم كقناة تنفيذ لنقل المهام ومزامنتها على عتاد المسرّعات.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 532df7849f07المصدرأسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
تُستخدم كقناة تنفيذ لنقل المهام ومزامنتها على عتاد المسرّعات.
يتم الإنشاء حصرياً عبر دوال المصنع الثابتة Create()، والتي تُعيد الكائن مغلفاً في std::unique_ptr<Queue> داخل ara::core::Result. ويمكن إجراء إنشاء المثيل إما بناءً على مرجع Device موجود [AP_SWS_SHWA_00909] أو عبر DeviceSelector عام [AP_SWS_SHWA_00908]. يقبل كلا المتغيرين بالإضافة إلى ذلك ErrorHandler وPropertyList اختيارية. وفيما يتعلق بالتزامن، تم تحديد دوال المصنع Create() بأنها آمنة بالنسبة للخيوط [AP_SWS_SHWA_00908]، [AP_SWS_SHWA_00909]. في المقابل، أُعلن عن جميع دوال الأعضاء العادية للمثيل المنشأ – بما في ذلك Submit() وWait() وGetDevice() – بأنها غير آمنة بالنسبة للخيوط [AP_SWS_SHWA_00910]، [AP_SWS_SHWA_00912]، [AP_SWS_SHWA_00914]؛ وبالتالي يجب مزامنة عمليات الوصول المتزامنة من خيوط متعددة من جانب التطبيق.
مسار الاستخدام
ينقسم المسار العادي إلى مراحل الإنشاء وجدولة الأوامر والمزامنة:
إنشاء Queue: ينشئ التطبيق الـ Queue عبر Create() باستخدام Device محدد أو DeviceSelector بالإضافة إلى روتينات معالجة الأخطاء [AP_SWS_SHWA_00909].
إرسال الأمر: باستخدام Submit()، يتم تسليم مهمة إلى العتاد. وهنا يمكن إما تمرير ErrorHandler مخصص [AP_SWS_SHWA_00912] أو تحديد Queue ثانوية (secondaryQueue) للمسارات البديلة أو اللاحقة [AP_SWS_SHWA_00913]. تُرجع الدالة ara::core::Result<Event>.
المزامنة: يتزامن التطبيق مع اكتمال المهام المقدمة. ولهذا الغرض، يتوفر Wait() غير المحدود [AP_SWS_SHWA_00914] أو WaitFor() المحدد زمنياً مع تحديد مدة بالمللي ثانية [AP_SWS_SHWA_00917].
تبلغ الدوال عن حالات الخطأ عبر نوع رمز الخطأ ShwaErrorCode في ara::core::Result:
تعارضات الموارد والمعلمات: إذا فشل Create()، فقد تحدث أمور من بينها ShwaErrorCode::kResourceBusy، أو ShwaErrorCode::kInvalidParameter، أو ShwaErrorCode::kFeatureNotSupported[AP_SWS_SHWA_00909]. وتنطبق دلالات التراجع (Rollback) على أخطاء الإنشاء هذه.
استدعاء كائنات غير صالحة: إذا نُفذت دوال مثل Submit() أو Wait() أو WaitFor() على كائنات مدمرة بالفعل أو غير صالحة، تؤكد واجهة API ذلك عبر ShwaErrorCode::kInvalidObject[AP_SWS_SHWA_00912]، [AP_SWS_SHWA_00914]، [AP_SWS_SHWA_00917].
أخطاء التنفيذ وسلامة البيانات: إذا حدث خطأ أثناء معالجة المهمة (ShwaErrorCode::kTaskExecutionFailure أو بشكل أعم ShwaErrorCode::kRuntime)، فلا توجد دلالات تراجع (Rollback) بشكل صريح (no_rollback_semantics). وتتطلب المواصفة في هذه الحالات اعتبار البيانات المشاركة في التنفيذ على أنها عُدّلت عن غير قصد [AP_SWS_SHWA_00912]، [AP_SWS_SHWA_00914].
تجاوز المهلة الزمنية: عند الانتظار المتزامن عبر WaitFor()، يشير ShwaErrorCode::kTimedOut إلى انتهاء المهلة المحددة؛ وهنا أيضاً يجب تصنيف البيانات المتأثرة على أنها قد تكون غير متسقة [AP_SWS_SHWA_00917].
يستند هذا الدليل حصرياً إلى متطلبات المواصفات الخاصة بـ ara::shwa::Queue من AUTOSAR Adaptive R25-11.
Erzeugt beziehungsweise liefert das in der Signatur beschriebene Objekt oder Ergebnis über den angegebenen Factory-Pfad.
Scope
class ara::shwa::Queue
Thread Safety
thread-safe rollback_semantics ShwaErrorCode::k Runtime General runtime error rollback_semantics ShwaErrorCode::k ResourceBusy The operation could not be performed because the resource is currently busy rollback_semantics ShwaErrorCode::kInvalid Parameter Invalid argument to an API function rollback_semantics
Exception Safety
exception safe
Errors
ShwaErrorCode::k FeatureNotSupported Used when a requested feature isn’t supported
Request a governed re-review of this record. The record is not changed immediately.
Erzeugt beziehungsweise liefert das in der Signatur beschriebene Objekt oder Ergebnis über den angegebenen Factory-Pfad.
Scope
class ara::shwa::Queue
Thread Safety
thread-safe rollback_semantics ShwaErrorCode::k Runtime General runtime error rollback_semantics ShwaErrorCode::k ResourceBusy The operation could not be performed because the resource is currently busy rollback_semantics ShwaErrorCode::kInvalid Parameter Invalid argument to an API function rollback_semantics
Exception Safety
exception safe
Errors
ShwaErrorCode::k FeatureNotSupported Used when a requested feature isn’t supported
Request a governed re-review of this record. The record is not changed immediately.
Die Spezifikation definiert diese Deklaration mit der in der Signatur ausgewiesenen Semantik.
Scope
class ara::shwa::Queue
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
Exception Safety
exception safe
Errors
ShwaErrorCode::k ResourceBusy no_rollback_semantics The operation could not be performed because the resource is currently busy no_rollback_semantics ShwaErrorCode::kInvalid Parameter Invalid argument to an API function no_rollback_semantics ShwaErrorCode::kInvalid Object Using a destroyed or invalid object (like a buffer or queue) 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
Request a governed re-review of this record. The record is not changed immediately.
Die Spezifikation definiert diese Deklaration mit der in der Signatur ausgewiesenen Semantik.
Scope
class ara::shwa::Queue
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::k ResourceBusy The operation could not be performed because the resource is currently busy no_rollback_semantics ShwaErrorCode::kInvalid Parameter Invalid argument to an API function no_rollback_semantics ShwaErrorCode::kInvalid Object Using a destroyed or invalid object (like a buffer or queue) no_rollback_semantics
Exception Safety
exception safe
Errors
ShwaErrorCode::kTask ExecutionFailure Error during task execution. 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.
Synchronisiert gemäß der Signatur auf den Abschluss assoziierter oder abhängiger Aufgaben; die zeitbegrenzte Variante begrenzt das Warten.
Scope
class ara::shwa::Queue
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 rollback_semantics ShwaErrorCode::k ResourceBusy The operation could not be performed because the resource is currently busy rollback_semantics ShwaErrorCode::kInvalid Object Using a destroyed or invalid object (like a buffer or queue) rollback_semantics ShwaErrorCode::k FeatureNotSupported Used when a requested feature isn’t supported no_rollback_semantics
Exception Safety
exception safe
Errors
ShwaErrorCode::kTask ExecutionFailure Error during task execution. 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.
Synchronisiert gemäß der Signatur auf den Abschluss assoziierter oder abhängiger Aufgaben; die zeitbegrenzte Variante begrenzt das Warten.
Scope
class ara::shwa::Queue
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 rollback_semantics ShwaErrorCode::k ResourceBusy The operation could not be performed because the resource is currently busy rollback_semantics ShwaErrorCode::kInvalid Object Using a destroyed or invalid object (like a buffer or queue) rollback_semantics ShwaErrorCode::k FeatureNotSupported Used when a requested feature isn’t supported 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::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 · الأصل الألماني