DEENESPTFRRUARHIKOZHNL

klasse ara::shwa::Event

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] tekst nog niet geïmporteerd Upstream: RS_SHWA_00016

class Event final {...};

Die Spezifikation definiert diesen Klassentyp mit der gezeigten Schnittstelle.

Header-Datei#include "ara/shwa/event.h"
Scopenamespace ara::shwa

User GuideAI-GEGENEREERD

Synchroniseert applicaties op de voltooiing van geassocieerde of afhankelijke hardwareversneller-taken.
DOOR AI GEGENEREERD ongecontroleerd Model: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: ca0070588ff8 Herkomst Open vragen (2)
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel

Synchroniseert applicaties op de voltooiing van geassocieerde of afhankelijke hardwareversneller-taken.

De klasse ara::shwa::Event dient voor synchronisatie op de voltooiing van hardwareversneller-taken in de module shwa [AP_SWS_SHWA_00604]. Na thread-safe factory-creatie via Create() [AP_SWS_SHWA_00602] vindt het wachten blokkerend of tijdgebonden plaats via niet-thread-safe methoden zoals Wait() of WaitFor(). Treedt bij de taakuitvoering een fout op, dan geldt er geen rollback-semantiek, waardoor gebruikte data als onbedoeld gewijzigd worden beschouwd [AP_SWS_SHWA_00604].

Context

De klasse ara::shwa::Event fungeert binnen de module shwa als centraal synchronisatie-element voor hardwareversneller-taken. Haar hoofdverantwoordelijkheid bestaat erin te synchroniseren op de voltooiing van geassocieerde of afhankelijke taken [AP_SWS_SHWA_00604]. Interactiepartners zijn aanroepende threads en applicatiecomponenten die asynchrone versnellerbewerkingen coördineren. Interpretatie: Aangezien de interface taakvoltooiingen synchroniseert, representeert een afzonderlijk Event-object vermoedelijk de uitvoerings- en synchronisatiesignalen van een specifieke hardware-uitvoering. Vraag Q-b4aa1debd356c45c (open)

Levenscyclus

Instanties van ara::shwa::Event worden aangemaakt via de statische factory-methode Create(), die een ara::core::Result<Event> retourneert [AP_SWS_SHWA_00602]. Dit creatiepad is thread-safe en werpt geen uitzonderingen (noexcept, exception safe) [AP_SWS_SHWA_00602]. Na aanmaak bevindt het object zich in de actieve bedrijfstoestand en maakt het het opvragen van afhankelijkheden en synchronisatiebewerkingen mogelijk.

Met betrekking tot concurrency moeten applicatiecomponenten er rekening mee houden dat alle instantiemethoden en synchronisatieaanroepen expliciet zijn gespecificeerd als niet-thread-safe (not thread-safe) [AP_SWS_SHWA_00603], [AP_SWS_SHWA_00604], [AP_SWS_SHWA_00605], [AP_SWS_SHWA_00606]. Gelijktijdige toegang van meerdere threads tot dezelfde event-instantie of gedeelde event-lijsten vereist daarom externe synchronisatie. De vernietiging van het object verloopt via de reguliere C++-levensduur; een expliciete sluit- of vrijgavemethode bestaat niet in de interface.

Gebruikspad

Het reguliere verloop voor synchronisatie is onderverdeeld in de objectcreatie, de optionele inspectie van afhankelijkheden en het daadwerkelijke wachten op de uitvoering:

  1. Instantiëring: De aanroeper roept Create() aan en controleert het verkregen ara::core::Result op succes [AP_SWS_SHWA_00602].
  2. Afhankelijkheden opvragen: Via GetWaitList() kan een lijst van afhankelijke events als ara::core::Vector<Event> worden uitgelezen [AP_SWS_SHWA_00603]. Vermoedelijk fungeert GetWaitList() als inspectie van voorafgaande taken op welker voltooiing het event intern is aangewezen. Vraag Q-ed01dc595c23ce28 (open)
  3. Synchronisatie uitvoeren: Voor synchronisatie staan drie varianten ter beschikking:
    • Instantiegebaseerd wachten via Wait() blokkeert op de voltooiing van de aan het event geassocieerde taken [AP_SWS_SHWA_00604].
    • Statisch wachten op een groep events via Wait(eventList) synchroniseert op een volledige collectie van Event-objecten [AP_SWS_SHWA_00605].
    • Tijdgebonden statisch wachten via WaitFor(ms) limiteert het wachten tot een gedefinieerde duur in milliseconden [AP_SWS_SHWA_00606].
Verloop van de event-synchronisatieAnwendungara::shwa::EventUse Case: InstanziierungCreate()ara::core::Result<Event>Use Case: Afhankelijkheidscontrole (optioneel)GetWaitList()ara::core::Result<Vector<Event>>Use Case: Synchronisationaltblokkerend wachten op instantieWait()ara::core::Result<void>zeitbegrenztes WartenWaitFor(ms)ara::core::Result<void>

Sequentiediagram: Typisch verloop van de creatie via het opvragen van afhankelijkheden tot aan de synchronisatie. Bronnen: [AP_SWS_SHWA_00602], [AP_SWS_SHWA_00603], [AP_SWS_SHWA_00604], [AP_SWS_SHWA_00606]

Foutscenario's

Alle methoden zijn gedeclareerd met noexcept en melden fouttoestanden via het retourtype ara::core::Result. Daarbij treden specifieke foutcodes op:

Bijzondere aandacht vereist de rollback-semantiek: Voor de wachtbewerkingen Wait() en Wait(eventList) geldt no_rollback_semantics [AP_SWS_SHWA_00604], [AP_SWS_SHWA_00605]. Treedt een fout op bij de taakuitvoering, dan moeten de door de mislukte taak gebruikte gegevens als onbedoeld gewijzigd worden beschouwd [AP_SWS_SHWA_00604], [AP_SWS_SHWA_00605], [AP_SWS_SHWA_00606].

Deze handleiding is uitsluitend gebaseerd op de specificatie van de module shwa voor Release R25-11.

Ledenkaart

Detailweergave

Kies een item in de inhoudsopgave.

Methoden

Create functie

Erzeugt beziehungsweise liefert das in der Signatur beschriebene Objekt oder Ergebnis über den angegebenen Factory-Pfad.

static ara::core::Result< Event > Create () noexcept;
GetWaitList functie

Liest die durch die Signatur bezeichnete Information oder Eigenschaft aus dem Objekt.

ara::core::Result< ara::core::Vector< Event > > GetWaitList () noexcept;
Wait functie 2

Synchronisiert gemäß der Signatur auf den Abschluss assoziierter oder abhängiger Aufgaben; die zeitbegrenzte Variante begrenzt das Warten.

Overloads Wait 2
static ara::core::Result< void > Wait (const ara::core::Vector< Event > &eventList) noexcept; AP_SWS_SHWA_00605
ara::core::Result< void > Wait () noexcept; AP_SWS_SHWA_00604
WaitFor functie

Synchronisiert gemäß der Signatur auf den Abschluss assoziierter oder abhängiger Aufgaben; die zeitbegrenzte Variante begrenzt das Warten.

static ara::core::Result< void > WaitFor (const size_t ms) noexcept;

Details

functie Create [AP_SWS_SHWA_00602] Upstream: RS_SHWA_00007, RS_SHWA_00016

static ara::core::Result< Event > Create () noexcept;

Erzeugt beziehungsweise liefert das in der Signatur beschriebene Objekt oder Ergebnis über den angegebenen Factory-Pfad.

Scopeclass ara::shwa::Event
Thread Safetythread-safe rollback_semantics
Exception Safetyexception safe
ErrorsShwaErrorCode::k Runtime General runtime error

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/AP_SWS_SHWA_00602
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_SHWA_00602@rel:R25-11#c291c61d
Content hash
c291c61d
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_SafeHardwareAcceleration.pdf#nameddest=AP_SWS_SHWA_00602
Status: valid/unmigrated Version: rel:R25-11#257b2cab Versionshistorie & Revisions (1 transition)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/AP_SWS_SHWA_00602@rel:R25-11#257b2cab
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

functie GetWaitList [AP_SWS_SHWA_00603] Upstream: RS_SHWA_00007, RS_SHWA_00016

ara::core::Result< ara::core::Vector< Event > > GetWaitList () noexcept;

Liest die durch die Signatur bezeichnete Information oder Eigenschaft aus dem Objekt.

Scopeclass ara::shwa::Event
Thread Safetynot thread-safe rollback_semantics ShwaErrorCode::k Runtime General runtime error rollback_semantics
Exception Safetyexception safe
ErrorsShwaErrorCode::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.

Record
AUTOSAR/AP/record/AP_SWS_SHWA_00603
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_SHWA_00603@rel:R25-11#eabefb81
Content hash
eabefb81
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_SafeHardwareAcceleration.pdf#nameddest=AP_SWS_SHWA_00603
Status: valid/unmigrated Version: rel:R25-11#3d013547 Versionshistorie & Revisions (1 transition)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/AP_SWS_SHWA_00603@rel:R25-11#3d013547
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

functie Wait [AP_SWS_SHWA_00605] Upstream: RS_SHWA_00007, RS_SHWA_00016

static ara::core::Result< void > Wait (const ara::core::Vector< Event > &eventList) noexcept;

Synchronisiert gemäß der Signatur auf den Abschluss assoziierter oder abhängiger Aufgaben; die zeitbegrenzte Variante begrenzt das Warten.

Scopeclass ara::shwa::Event
Thread Safetynot 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 Safetyexception safe
ErrorsShwaErrorCode::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.

Record
AUTOSAR/AP/record/AP_SWS_SHWA_00605
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_SHWA_00605@rel:R25-11#b8db94c2
Content hash
b8db94c2
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_SafeHardwareAcceleration.pdf#nameddest=AP_SWS_SHWA_00605
Status: valid/unmigrated Version: rel:R25-11#ab1e1fa9 Versionshistorie & Revisions (1 transition)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/AP_SWS_SHWA_00605@rel:R25-11#ab1e1fa9
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

functie Wait [AP_SWS_SHWA_00604] Upstream: RS_SHWA_00007, RS_SHWA_00016

ara::core::Result< void > Wait () noexcept;

Synchronisiert gemäß der Signatur auf den Abschluss assoziierter oder abhängiger Aufgaben; die zeitbegrenzte Variante begrenzt das Warten.

Scopeclass ara::shwa::Event
Thread Safetynot 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 Safetyexception safe
ErrorsShwaErrorCode::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.

Record
AUTOSAR/AP/record/AP_SWS_SHWA_00604
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_SHWA_00604@rel:R25-11#ff758877
Content hash
ff758877
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_SafeHardwareAcceleration.pdf#nameddest=AP_SWS_SHWA_00604
Status: valid/unmigrated Version: rel:R25-11#52685e47 Versionshistorie & Revisions (1 transition)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/AP_SWS_SHWA_00604@rel:R25-11#52685e47
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

functie WaitFor [AP_SWS_SHWA_00606] Upstream: RS_SHWA_00005, RS_SHWA_00007, RS_SHWA_00016

static ara::core::Result< void > WaitFor (const size_t ms) noexcept;

Synchronisiert gemäß der Signatur auf den Abschluss assoziierter oder abhängiger Aufgaben; die zeitbegrenzte Variante begrenzt das Warten.

Scopeclass ara::shwa::Event
Thread Safetynot 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 Safetyexception safe
ErrorsShwaErrorCode::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.

Record
AUTOSAR/AP/record/AP_SWS_SHWA_00606
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_SHWA_00606@rel:R25-11#f4c7e0b1
Content hash
f4c7e0b1
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_SafeHardwareAcceleration.pdf#nameddest=AP_SWS_SHWA_00606
Status: valid/unmigrated Version: rel:R25-11#2301dadd Versionshistorie & Revisions (1 transition)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/AP_SWS_SHWA_00606@rel:R25-11#2301dadd
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill