DEENESPTFRRUARHIKOZHNL

класс 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"
Scopenamespace ara::shwa

Руководство пользователяСОЗДАНО ИИ

Синхронизирует приложения с завершением связанных или зависимых задач аппаратных ускорителей.
СОЗДАНО ИИ не проверено Модель: gemini-3.8-flash-medium · Усилие: medium · Температура: не регулируется · Промпт: ca0070588ff8 Происхождение Открытые вопросы (2)
переведено с немецкого руководства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].

Контекст

Внутри модуля shwa класс ara::shwa::Event функционирует как центральный элемент синхронизации для задач аппаратных ускорителей. Его основная обязанность заключается в синхронизации с завершением связанных или зависимых задач [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++; явный метод закрытия или освобождения в интерфейсе отсутствует.

Путь использования

Штатная последовательность синхронизации включает в себя создание объекта, опциональный опрос зависимостей и непосредственное ожидание выполнения:

  1. Инстанцирование: вызывающая сторона вызывает Create() и проверяет полученный ara::core::Result на успешность [AP_SWS_SHWA_00602].
  2. Опрос зависимостей: через GetWaitList() можно прочитать список зависимых событий в виде ara::core::Vector<Event> [AP_SWS_SHWA_00603]. Предположительно, GetWaitList() функционирует как инспекция предшествующих задач, от завершения которых событие зависит внутренне. Вопрос Q-ed01dc595c23ce28 (открытый)
  3. Выполнение синхронизации: для синхронизации доступны три варианта:
    • Ожидание на основе экземпляра через Wait() блокирует выполнение до завершения задач, связанных с данным событием [AP_SWS_SHWA_00604].
    • Статическое ожидание группы событий через Wait(eventList) синхронизирует с целой коллекцией объектов Event [AP_SWS_SHWA_00605].
    • Ограниченное по времени статическое ожидание через WaitFor(ms) ограничивает ожидание заданной длительностью в миллисекундах [AP_SWS_SHWA_00606].
Последовательность синхронизации событийПриложениеara::shwa::EventUse Case: InstanziierungCreate()ara::core::Result<Event>Use Case: Проверка зависимостей (опционально)GetWaitList()ara::core::Result<Vector<Event>>Use Case: Synchronisationaltблокирующее ожидание экземпляраWait()ara::core::Result<void>zeitbegrenztes WartenWaitFor(ms)ara::core::Result<void>

Диаграмма последовательности: типичный процесс от создания и опроса зависимостей до синхронизации. Источники: [AP_SWS_SHWA_00602], [AP_SWS_SHWA_00603], [AP_SWS_SHWA_00604], [AP_SWS_SHWA_00606]

Сценарии ошибок

Все методы объявлены с noexcept и сообщают о состояниях ошибок через возвращаемый тип ara::core::Result. При этом возникают специфические коды ошибок:

Особого внимания требует семантика отката: для операций ожидания 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].

Настоящее руководство основано исключительно на спецификации модуля shwa для релиза R25-11.

Карта членов

Подробный вид

Выберите элемент в оглавлении.

Методы

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.

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#7cf70ecd
Content hash
7cf70ecd
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

функция 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#26489316
Content hash
26489316
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

функция 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#9738cb94
Content hash
9738cb94
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

функция 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#575936ad
Content hash
575936ad
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

функция 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#449a294a
Content hash
449a294a
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