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] texto aún no importadoUpstream: RS_SHWA_00016
class Event final {...};
Die Spezifikation definiert diesen Klassentyp mit der gezeigten Schnittstelle.
Sincroniza aplicaciones respecto a la finalización de tareas asociadas o dependientes del acelerador de hardware.
GENERADO POR IAno revisadoModelo: gemini-3.8-flash-medium · Esfuerzo: medium · Temperatura: no controlable · Prompt: ca0070588ff8ProcedenciaPreguntas abiertas (2)
traducido de la guía alemanagemini-3.8-flash-low · 2026-10-13 · Original en alemán
Sincroniza aplicaciones respecto a la finalización de tareas asociadas o dependientes del acelerador de hardware.
La clase ara::shwa::Event sirve para la sincronización con la finalización de tareas del acelerador de hardware en el módulo shwa[AP_SWS_SHWA_00604]. Tras la creación segura para subprocesos mediante el método de fábrica a través de Create()[AP_SWS_SHWA_00602], la espera se realiza de forma bloqueante o limitada en el tiempo mediante métodos no seguros para subprocesos como Wait() o WaitFor(). Si se produce un error durante la ejecución de la tarea, no se aplica ninguna semántica de reversión (rollback), por lo que los datos utilizados se consideran modificados involuntariamente [AP_SWS_SHWA_00604].
Contexto
La clase ara::shwa::Event actúa dentro del módulo shwa como elemento central de sincronización para tareas del acelerador de hardware. Su responsabilidad principal consiste en sincronizar con la finalización de tareas asociadas o dependientes [AP_SWS_SHWA_00604]. Las partes que interactúan son subprocesos del lado del llamador y componentes de aplicación que coordinan operaciones asíncronas del acelerador. Interpretación: Dado que la interfaz sincroniza finalizaciones de tareas, es probable que un único objeto Event encapsule las señales de ejecución y sincronización de una ejecución de hardware específica. Pregunta Q-b4aa1debd356c45c (abierta)
Ciclo de vida
Las instancias de ara::shwa::Event se crean a través del método de fábrica estático Create(), que devuelve un ara::core::Result<Event>[AP_SWS_SHWA_00602]. Esta ruta de creación es segura para subprocesos (thread-safe) y no lanza excepciones (noexcept, exception safe) [AP_SWS_SHWA_00602]. Tras la creación, el objeto se encuentra en estado operativo activo y permite consultar dependencias así como operaciones de sincronización.
En cuanto a la concurrencia, los componentes de aplicación deben tener en cuenta que todos los métodos de instancia, así como las llamadas de sincronización, están especificados explícitamente como no seguros para subprocesos (not thread-safe) [AP_SWS_SHWA_00603], [AP_SWS_SHWA_00604], [AP_SWS_SHWA_00605], [AP_SWS_SHWA_00606]. Por lo tanto, el acceso simultáneo de varios subprocesos a la misma instancia de evento o a listas de eventos compartidas requiere sincronización externa. La destrucción del objeto se produce a través de la vida útil regular de C++; en la interfaz no existe un método explícito de cierre o liberación.
Ruta de uso
El flujo regular de sincronización se divide en la creación del objeto, la inspección opcional de dependencias y la espera propiamente dicha de la ejecución:
Instanciación: El llamador invoca Create() y comprueba el éxito del ara::core::Result obtenido [AP_SWS_SHWA_00602].
Consultar dependencias: A través de GetWaitList() se puede leer una lista de eventos dependientes como ara::core::Vector<Event>[AP_SWS_SHWA_00603]. Se asume que GetWaitList() actúa como inspección de tareas previas de cuya finalización depende internamente el evento. Pregunta Q-ed01dc595c23ce28 (abierta)
Ejecutar sincronización: Para la sincronización hay tres variantes disponibles:
La espera basada en instancia mediante Wait() se bloquea hasta la finalización de las tareas asociadas al evento [AP_SWS_SHWA_00604].
La espera estática de un grupo de eventos mediante Wait(eventList) sincroniza con una colección completa de objetos Event[AP_SWS_SHWA_00605].
La espera estática con límite de tiempo mediante WaitFor(ms) limita la espera a una duración definida en milisegundos [AP_SWS_SHWA_00606].
Todos los métodos están declarados con noexcept y notifican estados de error a través del tipo de retorno ara::core::Result. En este caso se presentan códigos de error específicos:
ShwaErrorCode::kTimedOut: Se produce exclusivamente en WaitFor(ms) cuando el tiempo de espera predeterminado ha expirado antes de que la tarea pudiera completarse [AP_SWS_SHWA_00606].
Se requiere especial atención a la semántica de reversión: Para las operaciones de espera Wait() y Wait(eventList) se aplica no_rollback_semantics[AP_SWS_SHWA_00604], [AP_SWS_SHWA_00605]. Si se produce un error durante la ejecución de la tarea, los datos utilizados por la tarea fallida deben considerarse modificados involuntariamente [AP_SWS_SHWA_00604], [AP_SWS_SHWA_00605], [AP_SWS_SHWA_00606].
Esta guía se basa exclusivamente en la especificación del módulo shwa para la versión 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-low· 2026-10-13 · Original en alemán