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 ainda não importadoUpstream: RS_SHWA_00016
class Event final {...};
Die Spezifikation definiert diesen Klassentyp mit der gezeigten Schnittstelle.
Sincroniza aplicações quanto à conclusão de tarefas de acelerador de hardware associadas ou dependentes.
GERADO POR IAnão revisadoModelo: gemini-3.8-flash-medium · Esforço: medium · Temperatura: não controlável · Prompt: ca0070588ff8ProcedênciaPerguntas em aberto (2)
traduzido do guia alemãogemini-3.8-flash-low · 2026-10-13 · Original em alemão
Sincroniza aplicações quanto à conclusão de tarefas de acelerador de hardware associadas ou dependentes.
A classe ara::shwa::Event serve para sincronização quanto à conclusão de tarefas de acelerador de hardware no módulo shwa[AP_SWS_SHWA_00604]. Após a criação segura para threads via fábrica com Create()[AP_SWS_SHWA_00602], a espera ocorre de forma bloqueante ou com limite de tempo por meio de métodos não seguros para threads, como Wait() ou WaitFor(). Se ocorrer um erro durante a execução da tarefa, nenhuma semântica de rollback entra em ação, motivo pelo qual os dados utilizados são considerados modificados de forma não intencional [AP_SWS_SHWA_00604].
Contexto
A classe ara::shwa::Event atua no módulo shwa como elemento central de sincronização para tarefas de acelerador de hardware. Sua principal responsabilidade é sincronizar quanto à conclusão de tarefas associadas ou dependentes [AP_SWS_SHWA_00604]. Os parceiros de interação são threads do lado do chamador e componentes de aplicação que coordenam operações assíncronas do acelerador. Interpretação: como a interface sincroniza conclusões de tarefas, presume-se que um único objeto Event encapsule os sinais de execução e sincronização de uma execução específica de hardware. Pergunta Q-b4aa1debd356c45c (aberta)
Ciclo de vida
Instâncias de ara::shwa::Event são criadas por meio do método de fábrica estático Create(), que retorna um ara::core::Result<Event>[AP_SWS_SHWA_00602]. Esse caminho de criação é seguro para threads (thread-safe) e não lança exceções (noexcept, exception safe) [AP_SWS_SHWA_00602]. Após a criação, o objeto está no estado de operação ativo e permite a consulta de dependências, bem como operações de sincronização.
Em relação à concorrência, os componentes de aplicação devem observar que todos os métodos de instância, assim como as chamadas de sincronização, são explicitamente especificados como não seguros para threads (not thread-safe) [AP_SWS_SHWA_00603], [AP_SWS_SHWA_00604], [AP_SWS_SHWA_00605], [AP_SWS_SHWA_00606]. O acesso simultâneo de múltiplas threads à mesma instância de evento ou a listas de eventos compartilhadas requer, portanto, sincronização externa. A destruição do objeto segue o ciclo de vida regular do C++; não existe um método explícito de fechamento ou liberação na interface.
Caminho de utilização
O fluxo regular para sincronização é dividido na criação do objeto, na inspeção opcional de dependências e na espera propriamente dita pela execução:
Instanciação: o chamador invoca Create() e verifica se o ara::core::Result obtido indica sucesso [AP_SWS_SHWA_00602].
Consultar dependências: por meio de GetWaitList(), uma lista de eventos dependentes pode ser lida como ara::core::Vector<Event>[AP_SWS_SHWA_00603]. Provavelmente, GetWaitList() funciona como uma inspeção de tarefas prévias de cuja conclusão o evento depende internamente. Pergunta Q-ed01dc595c23ce28 (aberta)
Executar sincronização: para a sincronização, estão disponíveis três variantes:
A espera baseada em instância por meio de Wait() bloqueia até a conclusão das tarefas associadas ao evento [AP_SWS_SHWA_00604].
A espera estática por um grupo de eventos por meio de Wait(eventList) sincroniza com base em uma coleção inteira de objetos Event[AP_SWS_SHWA_00605].
A espera estática com tempo limitado por meio de WaitFor(ms) limita a espera a uma duração definida em milissegundos [AP_SWS_SHWA_00606].
Todos os métodos são declarados com noexcept e reportam estados de erro por meio do tipo de retorno ara::core::Result. Nesse contexto, ocorrem códigos de erro específicos:
ShwaErrorCode::kTimedOut: Ocorre exclusivamente em WaitFor(ms) quando o tempo de espera especificado expira antes que a tarefa possa ser concluída [AP_SWS_SHWA_00606].
Uma atenção especial deve ser dada à semântica de rollback: para as operações de espera Wait() e Wait(eventList), aplica-se no_rollback_semantics[AP_SWS_SHWA_00604], [AP_SWS_SHWA_00605]. Se ocorrer um erro durante a execução da tarefa, os dados utilizados pela tarefa com falha devem ser considerados como modificados de forma não intencional [AP_SWS_SHWA_00604], [AP_SWS_SHWA_00605], [AP_SWS_SHWA_00606].
Este guia baseia-se exclusivamente na especificação do módulo shwa para a versão 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 em alemão