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] wording not yet importedUpstream: RS_SHWA_00016
class Event final {...};
Die Spezifikation definiert diesen Klassentyp mit der gezeigten Schnittstelle.
Synchronizes applications to the completion of associated or dependent hardware accelerator tasks.
AI-GENERATEDunreviewedModel: gemini-3.8-flash-medium · Effort: medium · Temperature: not controllable · Prompt: ca0070588ff8ProvenanceOpen questions (2)
translated from the German guidegemini-3.8-flash-low · 2026-10-13 · German original
Synchronizes applications to the completion of associated or dependent hardware accelerator tasks.
The class ara::shwa::Event serves to synchronize to the completion of hardware accelerator tasks in the shwa module [AP_SWS_SHWA_00604]. After thread-safe factory creation via Create()[AP_SWS_SHWA_00602], waiting is performed blocking or timed via non-thread-safe methods such as Wait() or WaitFor(). If an error occurs during task execution, no rollback semantics apply, which is why utilized data are considered modified unintentionally [AP_SWS_SHWA_00604].
Context
The class ara::shwa::Event functions within module shwa as a central synchronization element for hardware accelerator tasks. Its main responsibility is to synchronize to the completion of associated or dependent tasks [AP_SWS_SHWA_00604]. Interaction partners are caller-side threads and application components that coordinate asynchronous accelerator operations. Interpretation: Since the interface synchronizes task completions, a single Event object likely encapsulates the execution and synchronization signals of a specific hardware execution. Question Q-b4aa1debd356c45c (open)
Lifecycle
Instances of ara::shwa::Event are created via the static factory method Create(), which returns a ara::core::Result<Event>[AP_SWS_SHWA_00602]. This creation path is thread-safe and does not throw exceptions (noexcept, exception safe) [AP_SWS_SHWA_00602]. After creation, the object is in the active operating state and enables the querying of dependencies as well as synchronization operations.
With regard to concurrency, application components must note that all instance methods as well as the synchronization calls are explicitly specified as not thread-safe [AP_SWS_SHWA_00603], [AP_SWS_SHWA_00604], [AP_SWS_SHWA_00605], [AP_SWS_SHWA_00606]. Concurrent access by multiple threads to the same event instance or shared event lists therefore requires external synchronization. Destruction of the object occurs via regular C++ lifetime; an explicit closing or releasing method does not exist in the interface.
Usage Path
The regular sequence for synchronization is divided into object creation, optional inspection of dependencies, and the actual waiting for execution:
Instantiation: The caller invokes Create() and checks the obtained ara::core::Result for success [AP_SWS_SHWA_00602].
Querying dependencies: Via GetWaitList(), a list of dependent events can be read out as ara::core::Vector<Event>[AP_SWS_SHWA_00603]. Presumably, GetWaitList() functions as an inspection of upstream tasks on whose completion the event internally depends. Question Q-ed01dc595c23ce28 (open)
Executing synchronization: Three variants are available for synchronization:
Instance-based waiting via Wait() blocks on the completion of tasks associated with the event [AP_SWS_SHWA_00604].
Static waiting for a group of events via Wait(eventList) synchronizes to an entire collection of Event objects [AP_SWS_SHWA_00605].
Timed static waiting via WaitFor(ms) limits waiting to a defined duration in milliseconds [AP_SWS_SHWA_00606].
ShwaErrorCode::kTimedOut: Occurs exclusively with WaitFor(ms) when the specified waiting time has expired before the task could be completed [AP_SWS_SHWA_00606].
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 · German original