클래스 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 생성

연관되거나 종속된 하드웨어 가속기 태스크의 완료에 맞추어 애플리케이션을 동기화합니다.

AI 생성 미검증 모델: 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].

컨텍스트

ara::shwa::Event 클래스는 shwa 모듈 내에서 하드웨어 가속기 태스크를 위한 중앙 동기화 요소로 기능합니다. 주된 역할은 연관되거나 종속된 태스크의 완료에 맞추어 동기화하는 것입니다 [AP_SWS_SHWA_00604]. 상호작용 대상은 비동기 가속기 작업을 조정하는 호출자 측 스레드 및 애플리케이션 컴포넌트입니다. 해석: 인터페이스가 태스크 완료를 동기화하므로, 단일 Event 객체는 특정 하드웨어 실행의 실행 및 동기화 신호를 캡슐화할 것으로 보입니다. 질문 Q-b4aa1debd356c45c (열림)

수명 주기

ara::shwa::Event의 인스턴스는 ara::core::Result<Event>을(를) 반환하는 정적 팩토리 메서드 Create()을(를) 통해 생성됩니다 [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]. 따라서 여러 스레드가 동일한 Event 인스턴스 또는 공유 Event 목록에 동시에 접근하려면 외부 동기화가 필요합니다. 객체의 소멸은 일반적인 C++ 수명 주기를 통해 이루어지며, 인터페이스에 명시적인 닫기 또는 해제 메서드는 존재하지 않습니다.

사용 경로

동기화를 위한 정규 절차는 객체 생성, 종속성에 대한 선택적 검사, 그리고 실행에 대한 실제 대기로 구성됩니다:

인스턴스화: 호출자가 Create()을(를) 호출하고 수신된 ara::core::Result의 성공 여부를 검사합니다 [AP_SWS_SHWA_00602].
종속성 쿼리: GetWaitList()을(를) 통해 종속 Event 목록을 ara::core::Vector<Event>(으)로 읽어올 수 있습니다 [AP_SWS_SHWA_00603]. GetWaitList()은(는) Event가 내부적으로 완료 여부에 의존하는 선행 태스크를 검사하는 역할을 할 것으로 추정됩니다. 질문 Q-ed01dc595c23ce28 (열림)
동기화 수행: 동기화에는 세 가지 변형을 사용할 수 있습니다:
- Wait()을(를) 통한 인스턴스 기반 대기는 Event에 연관된 태스크의 완료까지 블로킹됩니다 [AP_SWS_SHWA_00604].
- Wait(eventList)을(를) 통한 Event 그룹에 대한 정적 대기는 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: 잘못된 대기 작업과 같이 Event에 대한 유효하지 않은 작업 [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].

이 가이드는 R25-11 릴리스의 shwa 모듈 명세만을 기반으로 합니다.

멤버 맵

메서드

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#2c3494ec
Content hash: 2c3494ec
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#590e0a40
Content hash: 590e0a40
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#f690a81e
Content hash: f690a81e
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#cabc016f
Content hash: cabc016f
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#7a1e3c7f
Content hash: 7a1e3c7f
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

사용자 가이드AI 생성

컨텍스트

수명 주기

사용 경로

오류 시나리오

멤버 맵

메서드

상세 보기

메서드

세부 정보

함수 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: