类 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] 原文尚未导入 Upstream: RS_SHWA_00016

class Event final {...};

Die Spezifikation definiert diesen Klassentyp mit der gezeigten Schnittstelle.

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

用户指南人工智能生成

将应用程序同步至关联或依赖的硬件加速器任务的完成。

AI 生成未审核模型： gemini-3.8-flash-medium · 推理强度： medium · 温度：不可控 · 提示词： ca0070588ff8 来源未决问题（2）

译自德文指南AI 生成gemini-3.8-flash-low · 2026-10-13 · 德文原文

将应用程序同步至关联或依赖的硬件加速器任务的完成。

类 ara::shwa::Event 用于在模块 shwa [AP_SWS_SHWA_00604] 中同步至硬件加速器任务的完成。在通过 Create() [AP_SWS_SHWA_00602] 完成线程安全的工厂创建后，通过非线程安全的方法（如 Wait() 或 WaitFor()）执行阻塞式或限时等待。若在任务执行期间发生错误，则不会触发回滚语义，因此所使用的数据被视为被意外修改 [AP_SWS_SHWA_00604]。

上下文

类 ara::shwa::Event 在模块 shwa 内部充当硬件加速器任务的核心同步元素。其主要职责是同步至关联或依赖任务的完成 [AP_SWS_SHWA_00604]。交互方是协调异步加速器操作的调用方线程和应用程序组件。解释：由于该接口负责同步任务完成情况，单个 Event 对象可能封装了特定硬件执行的执行与同步信号。问题 Q-b4aa1debd356c45c (未决)

生命周期

ara::shwa::Event 的实例通过静态工厂方法 Create() 创建，该方法返回 ara::core::Result<Event> [AP_SWS_SHWA_00602]。该创建路径是线程安全的（thread-safe），并且不抛出异常（noexcept，exception safe）[AP_SWS_SHWA_00602]。创建完成后，该对象处于活动运行状态，并支持依赖项查询以及同步操作。

在并发性方面，应用程序组件必须注意，所有实例方法以及同步调用均显式指定为非线程安全（not thread-safe）[AP_SWS_SHWA_00603]、[AP_SWS_SHWA_00604]、[AP_SWS_SHWA_00605]、[AP_SWS_SHWA_00606]。因此，多个线程并发访问同一事件实例或共享事件列表需要外部同步。对象的销毁遵循常规 C++ 生命周期；接口中不存在显式的关闭或释放方法。

使用路径

常规同步流程分为对象创建、可选的依赖项检查以及实际等待执行：

实例化：调用方调用 Create() 并检查返回的 ara::core::Result 是否成功 [AP_SWS_SHWA_00602]。
查询依赖项：通过 GetWaitList() 可以将依赖事件的列表作为 ara::core::Vector<Event> 读取 [AP_SWS_SHWA_00603]。推测 GetWaitList() 用于检查前置任务，该事件内部依赖于这些前置任务的完成。问题 Q-ed01dc595c23ce28 (未决)
执行同步：有三种变体可用于同步：
- 基于实例的通过 Wait() 进行的等待会阻塞，直到与该事件关联的任务完成 [AP_SWS_SHWA_00604]。
- 通过 Wait(eventList) 静态等待一组事件会同步至 Event 对象的整个集合 [AP_SWS_SHWA_00605]。
- 通过 WaitFor(ms) 进行限时静态等待将等待限制在以毫秒为单位的定义持续时间内 [AP_SWS_SHWA_00606]。

时序图：从创建、依赖项查询到同步的典型流程。来源：[AP_SWS_SHWA_00602]、[AP_SWS_SHWA_00603]、[AP_SWS_SHWA_00604]、[AP_SWS_SHWA_00606]

错误场景

所有方法均使用 noexcept 声明，并通过返回类型 ara::core::Result 报告错误状态。在此过程中会出现特定的错误代码：

ShwaErrorCode::kRuntime：通用运行时错误，可能在创建 [AP_SWS_SHWA_00602]、读取等待列表 [AP_SWS_SHWA_00603] 以及同步调用时发生 [AP_SWS_SHWA_00604]、[AP_SWS_SHWA_00605]、[AP_SWS_SHWA_00606]。
ShwaErrorCode::kEventInvalidOperation：针对事件的无效操作，例如不允许的等待过程 [AP_SWS_SHWA_00603]、[AP_SWS_SHWA_00604]、[AP_SWS_SHWA_00605]、[AP_SWS_SHWA_00606]。
ShwaErrorCode::kTaskExecutionFailure：执行关联任务期间发生错误 [AP_SWS_SHWA_00604]、[AP_SWS_SHWA_00605]、[AP_SWS_SHWA_00606]。
ShwaErrorCode::kTimedOut：仅在 WaitFor(ms) 中出现，当指定的等待时间在任务完成前耗尽时触发 [AP_SWS_SHWA_00606]。

需要特别注意回滚语义：对于等待操作 Wait() 和 Wait(eventList)，适用 no_rollback_semantics [AP_SWS_SHWA_00604]、[AP_SWS_SHWA_00605]。若在任务执行期间发生错误，则失败任务所使用的数据必须被视为被意外修改 [AP_SWS_SHWA_00604]、[AP_SWS_SHWA_00605]、[AP_SWS_SHWA_00606]。

本指南仅基于 Release R25-11 的 shwa 模块规范。

AI 生成未审核模型： gemini-3.8-flash-medium · 推理强度： medium · 温度：不可控 · 提示词： 45e20564e923 来源未决问题（2）

译自德文指南AI 生成gemini-3.8-flash-medium · 2026-10-14

用于在共享硬件加速模块中表示异步任务事件，并提供基于事件或超时的任务完成同步机制。

该类用于在共享硬件加速（SHWA）架构中表示事件并同步关联任务的完成状态[AP_SWS_SHWA_00604]。应用程序通过静态工厂方法创建实例，并支持单事件、多事件列表或指定毫秒超时等多种等待机制[AP_SWS_SHWA_00602]。所有等待操作均非线程安全且失败时无回滚语义，调用方须自行处理外部并发保护与异常数据状态。

上下文

在 AUTOSAR Adaptive Platform 的共享硬件加速（SHWA）架构中，ara::shwa::Event 承担着异步任务执行同步与状态追踪的核心职责。当应用程序向硬件加速执行单元分派密集计算或加速任务时，该类用于同步关联或依赖任务的完成状态[AP_SWS_SHWA_00604]。其实例可代表单个等待事件，也可作为批处理事件集合的元素参与多任务屏障同步[AP_SWS_SHWA_00605]。此外，对象提供了获取等待列表的能力，解读：GetWaitList() 可能用于查询当前事件对象内部维护或所依赖的等待事件集合[AP_SWS_SHWA_00603]。

生命周期

ara::shwa::Event 被定义为不可派生的终止类（final）。对象的实例化并不通过公开的常规构造函数完成，而是强制通过专用的静态工厂方法 Create() 创建并返回 ara::core::Result<Event>[AP_SWS_SHWA_00602]。在并发管理方面，规范对不同操作的线程安全性做出了明确区分：静态工厂方法 Create() 属于线程安全（thread-safe）实现，并提供异常安全性保证（exception safe）[AP_SWS_SHWA_00602]；而一旦对象被创建，其所有的同步与查询操作（包括 Wait()、WaitFor() 及 GetWaitList()）均被明确定义为非线程安全（not thread-safe）[AP_SWS_SHWA_00603]、[AP_SWS_SHWA_00604]、[AP_SWS_SHWA_00605]、[AP_SWS_SHWA_00606]。这意味着在并发多线程环境中访问同一个事件实例或事件列表时，调用者必须在应用层提供互斥机制。

使用路径

应用程序操作 ara::shwa::Event 的典型使用路径包括对象的工厂创建、可选的依赖查询以及最终的任务完成同步：

创建事件实例：调用静态工厂方法 Event::Create()，并检查返回的 ara::core::Result 以获取有效的事件实例[AP_SWS_SHWA_00602]。
查询事件属性：按需调用 GetWaitList() 获取内部关联的等待事件向量 ara::core::Vector<Event>[AP_SWS_SHWA_00603]。
单事件阻塞等待：调用成员方法 Wait() 无期限挂起当前执行流，直至关联任务完成[AP_SWS_SHWA_00604]。
批量多事件同步：将多个事件组装为 ara::core::Vector<Event> 并传入静态方法 Event::Wait(eventList)，同步等待列表中的所有任务达成[AP_SWS_SHWA_00605]。
限时超时等待：调用静态方法 Event::WaitFor(ms) 设定最大等待毫秒数，解读：该方法推测用于在当前执行环境中对关联任务实施带超时约束的等待[AP_SWS_SHWA_00606]。问题 (未决)

序列图：通过工厂方法创建事件并执行同步等待的调用流程。来源：[AP_SWS_SHWA_00602]、[AP_SWS_SHWA_00604]、[AP_SWS_SHWA_00605]、[AP_SWS_SHWA_00606]

错误场景

该类的所有方法均采用 noexcept 声明，遵循 AUTOSAR 规范基于 ara::core::Result 的错误处理模型。不同操作阶段可能返回的具体错误码如下：

ShwaErrorCode::kRuntime：通用运行时故障，可能在工厂创建 [AP_SWS_SHWA_00602]、属性读取 [AP_SWS_SHWA_00603] 或任何等待同步调用中发生[AP_SWS_SHWA_00604]、[AP_SWS_SHWA_00605]、[AP_SWS_SHWA_00606]。
ShwaErrorCode::kEvent（InvalidOperation）：针对事件本身的非法操作错误（例如对未就绪或非法状态的事件调用等待），可见于 GetWaitList()、Wait() 及 WaitFor()[AP_SWS_SHWA_00603]、[AP_SWS_SHWA_00604]、[AP_SWS_SHWA_00605]、[AP_SWS_SHWA_00606]。
ShwaErrorCode::kTask（ExecutionFailure）：任务在执行阶段遭遇故障。尤为关键的是，规范声明在此类失败中不保证回滚语义（no_rollback_semantics），调用方必须视失败任务内部所使用的数据为已发生非预期改变，不能假定数据保持原样[AP_SWS_SHWA_00604]、[AP_SWS_SHWA_00605]、[AP_SWS_SHWA_00606]。
ShwaErrorCode::kTimed（Out）：在调用 WaitFor() 时任务未能于指定的时间限制内完成，同样伴随无回滚语义的数据状态改变风险[AP_SWS_SHWA_00606]。

本指南由人工智能基于 AUTOSAR 规范需求自动化生成，用于指导开发人员理解与使用 ara::shwa::Event。

成员图

方法

Create GetWaitList Wait WaitFor

详细视图

请在大纲中选择一个条目。

此版本没有元素数据

方法

Create 函数

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

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

GetWaitList 函数

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

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

Wait 函数 2

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

重载 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 函数

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;

点击条目以查看其关系。

详细信息

函数 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.

Scope	class ara::shwa::Event
Thread Safety	thread-safe rollback_semantics
Exception Safety	exception safe
Errors	ShwaErrorCode::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#d42e6eb7
Content hash: d42e6eb7
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

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

函数 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.

Scope	class ara::shwa::Event
Thread Safety	not thread-safe rollback_semantics ShwaErrorCode::k Runtime General runtime error 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.

Record: AUTOSAR/AP/record/AP_SWS_SHWA_00603
Status: valid/unmigrated
Version: AUTOSAR/AP/record/AP_SWS_SHWA_00603@rel:R25-11#47562965
Content hash: 47562965
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

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

函数 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.

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.

Record: AUTOSAR/AP/record/AP_SWS_SHWA_00605
Status: valid/unmigrated
Version: AUTOSAR/AP/record/AP_SWS_SHWA_00605@rel:R25-11#4bb2f9de
Content hash: 4bb2f9de
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

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

函数 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.

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.

Record: AUTOSAR/AP/record/AP_SWS_SHWA_00604
Status: valid/unmigrated
Version: AUTOSAR/AP/record/AP_SWS_SHWA_00604@rel:R25-11#304242f0
Content hash: 304242f0
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

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

函数 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.

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.

Record: AUTOSAR/AP/record/AP_SWS_SHWA_00606
Status: valid/unmigrated
Version: AUTOSAR/AP/record/AP_SWS_SHWA_00606@rel:R25-11#f5a2a02d
Content hash: f5a2a02d
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

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

类 ara::shwa::Event

用户指南人工智能生成

上下文

生命周期

使用路径

错误场景

上下文

生命周期

使用路径

错误场景

成员图

方法

详细视图

方法

详细信息

函数 Create [AP_SWS_SHWA_00602] Upstream: RS_SHWA_00007, RS_SHWA_00016

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

函数 GetWaitList [AP_SWS_SHWA_00603] Upstream: RS_SHWA_00007, RS_SHWA_00016

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

函数 Wait [AP_SWS_SHWA_00605] Upstream: RS_SHWA_00007, RS_SHWA_00016

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

函数 Wait [AP_SWS_SHWA_00604] Upstream: RS_SHWA_00007, RS_SHWA_00016

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

函数 WaitFor [AP_SWS_SHWA_00606] Upstream: RS_SHWA_00005, RS_SHWA_00007, RS_SHWA_00016

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents: