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.
वर्ग ara::shwa::Queue Adaptive Platform में सुरक्षित हार्डवेयर त्वरण के लिए केंद्रीय निष्पादन चैनल का प्रतिनिधित्व करता है। जैसा कि समग्र डिज़ाइन दर्शाता है, अनुप्रयोग आमतौर पर कई कतारों, डिवाइसेस और बफ़र्स के संयोजन के साथ इंटरैक्ट करते हैं SWS_SafeHardwareAcceleration पृ. 22 “Figure 7.1: High Level Design of Safe Hardware Acceleration in an Adaptive Platform”। इस परस्पर क्रिया के भीतर, कतार गणना कार्यों या त्वरण आदेशों को प्राप्त करने और उन्हें अंतर्निहित हार्डवेयर डिवाइस पर अग्रेषित करने का कार्य संभालती है। GetDevice() के माध्यम से संबद्ध डिवाइस की क्वेरी की जा सकती है [AP_SWS_SHWA_00910]। इसके अलावा, IsInOrder() के माध्यम से यह निर्धारित किया जा सकता है कि क्या कतार के भीतर आदेशों को कड़ाई से क्रमिक रूप से संसाधित किया जाता है [AP_SWS_SHWA_00911]। कतार की विशिष्ट क्षमताओं या मापदंडों की पहले से HasProperty() के माध्यम से जाँच की जा सकती है [AP_SWS_SHWA_00915] और GetProperty() के साथ पुनर्प्राप्त किया जा सकता है [AP_SWS_SHWA_00916]।
ara::shwa::Queue के इंस्टेंस एक सख्त स्वामित्व मॉडल के अधीन हैं। डिफ़ॉल्ट कंस्ट्रक्टर [AP_SWS_SHWA_00902] और कॉपी तथा मूव संचालन दोनों स्पष्ट रूप से हटा दिए गए हैं: कॉपी कंस्ट्रक्टर [AP_SWS_SHWA_00903], कॉपी असाइनमेंट [AP_SWS_SHWA_00904], मूव कंस्ट्रक्टर [AP_SWS_SHWA_00905] और मूव असाइनमेंट [AP_SWS_SHWA_00906] उपलब्ध नहीं हैं। इस प्रकार एक कतार न तो प्रतिलिपि बनाने योग्य है और न ही स्थानांतरित करने योग्य (व्याख्या: यह एक स्थायी रूप से स्थापित संसाधन का प्रतिनिधित्व करती है)। प्रश्न Q-9ce33460e375c45f (खुला)
निर्माण विशेष रूप से स्थिर फ़ैक्टरी विधियों Create() के माध्यम से होता है, जो ara::core::Result के भीतर एक std::unique_ptr<Queue> में इनकैप्सुलेटेड ऑब्जेक्ट को लौटाते हैं। इंस्टेंटिएशन या तो मौजूदा 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]; परिणामस्वरूप, एकाधिक थ्रेड्स से समवर्ती एक्सेस को अनुप्रयोग स्तर पर सिंक्रनाइज़ किया जाना चाहिए।
उपयोग पथ
नियमित प्रवाह निर्माण, कार्य शेड्यूलिंग और सिंक्रनाइज़ेशन के चरणों में विभाजित है:
कतार बनाएँ: अनुप्रयोग किसी विशिष्ट डिवाइस या DeviceSelector के साथ-साथ त्रुटि प्रबंधन रूटीन्स के साथ Create() के माध्यम से कतार बनाता है [AP_SWS_SHWA_00909]।
कार्य सबमिट करें:Submit() के साथ हार्डवेयर को एक कार्य सौंपा जाता है। यहाँ या तो एक समर्पित ErrorHandler पास किया जा सकता है [AP_SWS_SHWA_00912] या फ़ॉलबैक अथवा अनुवर्ती पथों के लिए एक द्वितीयक कतार (secondaryQueue) निर्दिष्ट की जा सकती है [AP_SWS_SHWA_00913]। विधि एक ara::core::Result<Event> लौटाती है।
सिंक्रनाइज़ करें: अनुप्रयोग सबमिट किए गए कार्यों के पूरा होने पर सिंक्रनाइज़ करता है। इसके लिए असीमित Wait()[AP_SWS_SHWA_00914] या मिलीसेकंड अवधि के विनिर्देश के साथ समय-सीमित WaitFor() उपलब्ध है [AP_SWS_SHWA_00917]।
विधियाँ ara::core::Result में त्रुटि कोड प्रकार ShwaErrorCode के माध्यम से त्रुटि मामलों की रिपोर्ट करती हैं:
संसाधन और पैरामीटर विरोध: यदि Create() विफल हो जाता है, तो अन्य बातों के अलावा ShwaErrorCode::kResourceBusy, ShwaErrorCode::kInvalidParameter या ShwaErrorCode::kFeatureNotSupported हो सकते हैं [AP_SWS_SHWA_00909]। इन निर्माण त्रुटियों के लिए रोलबैक सिमेंटिक्स लागू होते हैं।
अमान्य ऑब्जेक्ट्स को कॉल करना: यदि पहले से नष्ट या अमान्य ऑब्जेक्ट्स पर Submit(), Wait() या WaitFor() जैसी विधियाँ निष्पादित की जाती हैं, तो API ShwaErrorCode::kInvalidObject[AP_SWS_SHWA_00912], [AP_SWS_SHWA_00914], [AP_SWS_SHWA_00917] के साथ इसकी पुष्टि करता है।
निष्पादन त्रुटि और डेटा अखंडता: यदि कार्य प्रसंस्करण के दौरान कोई त्रुटि (ShwaErrorCode::kTaskExecutionFailure या अधिक सामान्य रूप से ShwaErrorCode::kRuntime) उत्पन्न होती है, तो स्पष्ट रूप से कोई रोलबैक सिमेंटिक्स नहीं होता है (no_rollback_semantics)। इन मामलों में विनिर्देश की अपेक्षा है कि निष्पादन में शामिल डेटा को अनजाने में संशोधित माना जाना चाहिए [AP_SWS_SHWA_00912], [AP_SWS_SHWA_00914]।
समय समाप्ति:WaitFor() के माध्यम से सिंक्रोनाइज़िंग प्रतीक्षा के दौरान, ShwaErrorCode::kTimedOut निर्दिष्ट समय सीमा की समाप्ति का संकेत देता है; यहाँ भी प्रभावित डेटा को संभावित रूप से असंगत के रूप में वर्गीकृत किया जाना चाहिए [AP_SWS_SHWA_00917]।
यह मार्गदर्शिका विशेष रूप से AUTOSAR Adaptive R25-11 के ara::shwa::Queue से संबंधित विनिर्देश आवश्यकताओं पर आधारित है।
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 · जर्मन मूल