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] wording not yet importedUpstream: RS_SHWA_00001
class Queue final {...};
Die Spezifikation definiert diesen Klassentyp mit der gezeigten Schnittstelle.
The class ara::shwa::Queue represents the central execution channel for safe hardware acceleration in the Adaptive Platform. As illustrated by the overall design, applications typically interact with a combination of several queues, devices, and buffers SWS_SafeHardwareAcceleration p. 22 “Figure 7.1: High Level Design of Safe Hardware Acceleration in an Adaptive Platform”. Within this interaction, the queue assumes the task of accepting computation tasks or acceleration jobs and forwarding them to the underlying hardware device. The assigned device can be queried via GetDevice()[AP_SWS_SHWA_00910]. In addition, it can be determined via IsInOrder() whether jobs within the queue are processed strictly sequentially [AP_SWS_SHWA_00911]. Specific capabilities or parameters of the queue can be checked beforehand via HasProperty()[AP_SWS_SHWA_00915] and retrieved with GetProperty()[AP_SWS_SHWA_00916].
Creation occurs exclusively via static factory methods Create(), which return the object encapsulated in a std::unique_ptr<Queue> within a ara::core::Result. The instantiation can be performed either based on an existing Device reference [AP_SWS_SHWA_00909] or via a generic DeviceSelector[AP_SWS_SHWA_00908]. Both variants additionally accept a ErrorHandler and an optional PropertyList. Regarding concurrency, the factory functions Create() are specified as thread-safe [AP_SWS_SHWA_00908], [AP_SWS_SHWA_00909]. In contrast, all regular member functions of the created instance—including Submit(), Wait(), and GetDevice()—are declared as not thread-safe [AP_SWS_SHWA_00910], [AP_SWS_SHWA_00912], [AP_SWS_SHWA_00914]; concurrent accesses from multiple threads must consequently be synchronized on the application side.
Usage Path
The regular sequence is divided into the phases of creation, job scheduling, and synchronization:
Create queue: The application creates the queue via Create() with a concrete device or DeviceSelector as well as error handling routines [AP_SWS_SHWA_00909].
Submit job: With Submit(), a task is passed to the hardware. Here, either a dedicated ErrorHandler can be passed [AP_SWS_SHWA_00912] or a secondary queue (secondaryQueue) can be specified for fallback or subsequent paths [AP_SWS_SHWA_00913]. The method returns a ara::core::Result<Event>.
Synchronize: The application synchronizes on the completion of the submitted tasks. For this purpose, the unbounded Wait()[AP_SWS_SHWA_00914] or the time-limited WaitFor() with specification of a millisecond duration is available [AP_SWS_SHWA_00917].
The methods report error cases via the error code type ShwaErrorCode in ara::core::Result:
Resource and parameter conflicts: If Create() fails, ShwaErrorCode::kResourceBusy, ShwaErrorCode::kInvalidParameter, or ShwaErrorCode::kFeatureNotSupported, among others, can occur [AP_SWS_SHWA_00909]. Rollback semantics apply to these creation errors.
Call on invalid objects: If methods such as Submit(), Wait(), or WaitFor() are executed on already destroyed or invalid objects, the API acknowledges this with ShwaErrorCode::kInvalidObject[AP_SWS_SHWA_00912], [AP_SWS_SHWA_00914], [AP_SWS_SHWA_00917].
Execution errors and data integrity: If an error occurs during task execution (ShwaErrorCode::kTaskExecutionFailure or more generally ShwaErrorCode::kRuntime), there are explicitly no rollback semantics (no_rollback_semantics). In these cases, the specification requires that the data involved in the execution must be considered inadvertently modified [AP_SWS_SHWA_00912], [AP_SWS_SHWA_00914].
Timeout: During synchronizing waiting via WaitFor(), ShwaErrorCode::kTimedOut signals the expiration of the specified deadline; here as well, affected data must be classified as potentially inconsistent [AP_SWS_SHWA_00917].
This guide is based exclusively on the specification requirements for ara::shwa::Queue from 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 · German original