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] Wortlaut noch nicht übernommenUpstream: RS_SHWA_00016
class Event final {...};
Die Spezifikation definiert diesen Klassentyp mit der gezeigten Schnittstelle.
Synchronisiert Anwendungen auf den Abschluss assoziierter oder abhängiger Hardware-Beschleuniger-Aufgaben.
KI-GENERIERTungeprüftModell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: ca0070588ff8HerkunftOffene Fragen (2)
KI-generiertgemini-3.8-flash-medium · 2026-10-13
Synchronisiert Anwendungen auf den Abschluss assoziierter oder abhängiger Hardware-Beschleuniger-Aufgaben.
Die Klasse ara::shwa::Event dient der Synchronisation auf den Abschluss von Hardware-Beschleuniger-Aufgaben im Modul shwa[AP_SWS_SHWA_00604]. Nach threadsicherer Fabrikerzeugung via Create()[AP_SWS_SHWA_00602] erfolgt das Warten blockierend oder zeitbegrenzt über nicht threadsichere Methoden wie Wait() oder WaitFor(). Tritt bei der Aufgabenausführung ein Fehler auf, greift keine Rollback-Semantik, weshalb genutzte Daten als unbeabsichtigt modifiziert gelten [AP_SWS_SHWA_00604].
Kontext
Die Klasse ara::shwa::Event fungiert innerhalb des Moduls shwa als zentrales Synchronisationselement für Hardware-Beschleuniger-Aufgaben. Ihre Hauptverantwortung besteht darin, auf den Abschluss assoziierter oder abhängiger Aufgaben zu synchronisieren [AP_SWS_SHWA_00604]. Interaktionspartner sind aufruferseitige Threads und Anwendungskomponenten, die asynchrone Beschleuniger-Operationen koordinieren. Interpretation: Da die Schnittstelle Aufgabenabschlüsse synchronisiert, dürfte ein einzelnes Event-Objekt die Ausführungs- und Synchronisationssignale einer spezifischen Hardware-Ausführung kapseln. Frage Q-b4aa1debd356c45c (offen)
Lebenszyklus
Instanzen von ara::shwa::Event werden über die statische Fabrikmethode Create() erzeugt, welche ein ara::core::Result<Event> zurückliefert [AP_SWS_SHWA_00602]. Dieser Erzeugungspfad ist threadsicher (thread-safe) und wirft keine Ausnahmen (noexcept, exception safe) [AP_SWS_SHWA_00602]. Nach der Erzeugung befindet sich das Objekt im aktiven Betriebszustand und ermöglicht das Abfragen von Abhängigkeiten sowie Synchronisationsoperationen.
Hinsichtlich der Nebenläufigkeit müssen Anwendungskomponenten beachten, dass alle Instanzmethoden sowie die Synchronisationsaufrufe explizit als nicht threadsicher (not thread-safe) spezifiziert sind [AP_SWS_SHWA_00603], [AP_SWS_SHWA_00604], [AP_SWS_SHWA_00605], [AP_SWS_SHWA_00606]. Der gleichzeitige Zugriff mehrerer Threads auf dieselbe Event-Instanz oder gemeinsame Event-Listen erfordert daher eine externe Synchronisation. Die Zerstörung des Objekts erfolgt über die reguläre C++-Lebensdauer; eine explizite Schließ- oder Freigabemethode existiert in der Schnittstelle nicht.
Nutzungspfad
Der reguläre Ablauf zur Synchronisation gliedert sich in die Objekterzeugung, die optionale Inspektion von Abhängigkeiten und das eigentliche Warten auf die Ausführung:
Instanziierung: Der Aufrufer ruft Create() auf und prüft das erhaltene ara::core::Result auf Erfolg [AP_SWS_SHWA_00602].
Abhängigkeiten abfragen: Über GetWaitList() kann eine Liste abhängiger Events als ara::core::Vector<Event> ausgelesen werden [AP_SWS_SHWA_00603]. Vermutlich fungiert GetWaitList() als Inspektion vorgelagerter Aufgaben, auf deren Fertigstellung das Event intern angewiesen ist. Frage Q-ed01dc595c23ce28 (offen)
Synchronisation ausführen: Zur Synchronisation stehen drei Varianten zur Verfügung:
Instanzbasiertes Warten über Wait() blockiert auf den Abschluss der dem Event assoziierten Aufgaben [AP_SWS_SHWA_00604].
Statisches Warten auf eine Gruppe von Events über Wait(eventList) synchronisiert auf eine gesamte Kollektion von Event-Objekten [AP_SWS_SHWA_00605].
Zeitbegrenztes statisches Warten über WaitFor(ms) limitiert das Warten auf eine definierte Dauer in Millisekunden [AP_SWS_SHWA_00606].
ShwaErrorCode::kTimedOut: Tritt exklusiv bei WaitFor(ms) auf, wenn die vorgegebene Wartezeit abgelaufen ist, bevor die Aufgabe abgeschlossen werden konnte [AP_SWS_SHWA_00606].
Besondere Aufmerksamkeit erfordert die Rollback-Semantik: Für die Warteoperationen Wait() und Wait(eventList) gilt no_rollback_semantics[AP_SWS_SHWA_00604], [AP_SWS_SHWA_00605]. Tritt ein Fehler bei der Aufgabenausführung auf, müssen die von der fehlgeschlagenen Aufgabe genutzten Daten als unbeabsichtigt modifiziert betrachtet werden [AP_SWS_SHWA_00604], [AP_SWS_SHWA_00605], [AP_SWS_SHWA_00606].
Dieser Leitfaden basiert ausschließlich auf der Spezifikation des Moduls shwa für Release R25-11.
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-medium· 2026-10-13