类 ara::diag::Event

[SWS_DM_00646] Upstream: RS_Diag_04151

class Event final {...};

Class to implement operations on diagnostic Events.

Header-Datei	#include "ara/diag/event.h"
Forwarding-Header	#include "ara/diag/diag_fwd.h"
Scope	namespace ara::diag

用户指南人工智能生成

允许应用程序对诊断事件进行状态相关的监控、去抖动和 DTC 查询。

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

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

允许应用程序对诊断事件进行状态相关的监控、去抖动和 DTC 查询。

在 AUTOSAR Adaptive 中，类 ara::diag::Event 提供了用于监控诊断事件及其去抖动和错误状态的操作。应用程序通过 InstanceSpecifier 实例化该对象，注册可选的更改通知，并异步查询诊断与 DTC 信息 [SWS_DM_00647]。作为核心约束，该实例既不可拷贝也不可移动，且由于缺乏线程安全性，大多数查询方法在并发访问时需要应用端进行同步 [SWS_DM_00649]。

上下文

类 ara::diag::Event 在 AUTOSAR Adaptive Platform 中用作与诊断事件交互的主要接口。它充当应用特定软件与中央诊断管理之间的纽带。应用程序通过该接口监控事件的当前诊断和去抖动状态，或接收关于状态更改的通知。

在系统上下文中，主要有三个参与方参与该交互：

应用软件：实例化该类，发起状态查询并接收异步状态更新。
ara::diag::Event：封装类型化的诊断端口（DiagnosticEventInterface 的 PortPrototype），并提供跨线程或跨进程的查询方法。
Diagnostic Management (DM)：在服务端执行故障检测、DTC 分配和去抖动行为（Debouncing）。

上下文图：Event 类在应用软件与 Diagnostic Management 之间的归类。来源：[SWS_DM_00647]、[SWS_DM_00653]

生命周期

实例化通过显式传入 ara::core::InstanceSpecifier [SWS_DM_00647] 进行。该标识符必须指向通过 DiagnosticEventInterface 类型化的 PortPrototype。构造函数是异常安全且线程安全的 [SWS_DM_00647]。

关于所有权关系，ara::diag::Event 被定义为不可拷贝且不可移动的单一实例：拷贝构造函数 [SWS_DM_01681]、移动构造函数 [SWS_DM_01682] 以及相应的赋值运算符（[SWS_DM_01679]、[SWS_DM_01680]）均被显式删除（=delete）。每个进程不得对同一个 InstanceSpecifier 进行多次实例化 [SWS_DM_00647]。

销毁通过析构函数 ~Event() [SWS_DM_00648] 进行。与构造函数不同，析构函数不是线程安全的。其余成员函数（除 GetDTCNumber 外）也被指定为非线程安全，因此在同一实例上的并发调用必须在应用端进行同步。在 Release R25-11 中，对此的相关术语已从可重入性（Reentrancy）统一为并发性（Concurrency）AUTOSAR_AP_SWS_Diagnostics §1 “Change History”。

使用路径

典型用例分为以下调用：

初始化：应用程序通过其 InstanceSpecifier [SWS_DM_00647] 创建实例。该绑定推测在初始化时建立与诊断守护进程的连接。问题 Q-78e4462a0d147cfb (未决)
注册通知器：为了进行监控，可选择通过 SetEventStatusChangedNotifier 注册回调 [SWS_DM_00650]。后续调用会覆盖之前设置的通知器。
状态查询：在运行期间，应用程序通过 ara::core::Future 异步查询诊断数据：
- GetEventStatus() 获取当前状态字节 [SWS_DM_00649]。
- GetDebouncingStatus() 返回当前去抖动状态 [SWS_DM_00654]。
- GetFaultDetectionCounter() 查询故障检测计数器（FDC）[SWS_DM_00656]。
- GetTestComplete() 检查测试是否已完成（FDC 达到 -128 或 127）[SWS_DM_00655]。
- GetDTCNumber(dtcFormat) 以所选格式提供关联的 DTC 编号，并设计为线程安全 [SWS_DM_00653]。

时序图：应用程序、Event 实例与 Diagnostic Management 之间的典型交互顺序。来源：[SWS_DM_00647]、[SWS_DM_00650]、[SWS_DM_00649]、[SWS_DM_00653]

错误场景

错误条件以实例化时的建模违规（Violations）或运行时的错误代码形式出现：

构造函数调用时的违规行为 [SWS_DM_00647]：
- InstanceSpecifierMappingIntegrityViolation：标识符在模型中无法解析或未引用 PortPrototype。
- PortInterfaceMappingViolation：所引用的 PortPrototype 未被类型化为 DiagnosticEventInterface。
- ProcessMappingViolation：未找到与该进程匹配的建模上下文。
- InstanceSpecifierAlreadyInUseViolation：该标识符在同一进程中已被一个活动实例使用。
通过 ara::core::Result 或 ara::core::Future 的运行时错误代码：
- DiagErrc::kServiceNotAvailable：如果 Diagnostic Management 的基本后台功能不可用，则在所有状态查询中出现（[SWS_DM_00649]、[SWS_DM_00653]、[SWS_DM_00654]、[SWS_DM_00655]、[SWS_DM_00656]）。通信推测通过 IPC 异步处理。问题 (未决)
- DiagErrc::kNoSuchDTC：当该事件未配置 DTC 时由 GetDTCNumber 报告 [SWS_DM_00653]。
- DiagErrc::kInvalidArgument：由 SetEventStatusChangedNotifier 返回，例如在传入值无效时 [SWS_DM_00650]。

本指南基于 Release R25-11 的 AUTOSAR Adaptive Platform 规范。

成员图

类图

Hohle Dreieckspfeile = Vererbung (zeigt zur Basisklasse); Klicken öffnet die jeweilige Klassenseite.

详细视图

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

此版本没有元素数据

构造函数和析构函数

Event 函数 3

Constructor Event class.

重载 Event 3

explicit Event (const ara::core::InstanceSpecifier &specifier) noexcept; SWS_DM_00647

Event (Event &)=delete; SWS_DM_01681

Event (Event &&) noexcept=delete; SWS_DM_01682

~Event 函数

Destructor of class Event.

~Event () noexcept;

方法

GetDebouncingStatus 函数

Get the current debouncing status.

ara::core::Future< DebouncingState > GetDebouncingStatus () noexcept;

GetDTCNumber 函数

Returns the DTC number related to this event instance.

ara::core::Future< std::uint32_t > GetDTCNumber (DTCFormatType dtc Format) noexcept;

GetEventStatus 函数

Returns the current diagnostic event status.

ara::core::Future< EventStatusByte > GetEventStatus () noexcept;

GetFaultDetectionCounter 函数

Returns the current value of the Fault Detection Counter (FDC) of this event.

ara::core::Future< std::int8_t > GetFaultDetectionCounter () noexcept;

GetTestComplete 函数

Get the status if the event has matured to test completed (corresponds to FDC = -128 or FDC = 127).

ara::core::Future< bool > GetTestComplete () noexcept;

SetEventStatusChangedNotifier 函数

Register a notifier function which is called if a diagnostic event is changed. A consecutive call of this method will overwrite the previous registered notifier.

ara::core::Result< void > SetEventStatusChangedNotifier (EventStatus ByteNotifier notifier) noexcept;

运算符

operator= 函数 2

Event shall be a single not assign-able instance.

重载 = 2

Event & operator= (Event &)=delete; SWS_DM_01679

Event & operator= (Event &&)=delete; SWS_DM_01680

点击条目以查看其关系。

方法文档

函数 Event [SWS_DM_00647] Upstream: RS_Diag_04151, RS_AP_00137, RS_AP_00170, RS_AP_00171, RS_AP_00172, RS_AP_00173

explicit Event (const ara::core::InstanceSpecifier &specifier) noexcept;

Constructor Event class.

Header-Datei	#include "ara/diag/event.h"
Scope	class ara::diag::Event
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe
Verletzungen (Violations)	InstanceSpeci- InstanceSpecifier either cannot be resolved in the model in the fierMappingIn- context of your executable, or it refers to a model element other tegrityViolation than a PortPrototype. PortInterfaceMap- A PortPrototype that is referenced by a pingViolation DiagnosticEventPortMapping needs to be typed by a DiagnosticEventInterface. ProcessMappingVio- Matching InstanceRef exists, but no matching (modelled) Process lation found that matches the (runtime) process. InstanceSpecifier- Violation message that is sent in case a constructor in the ara AlreadyInUseViola- framework was called with an InstanceSpecifier already in use in tion this process.

Parameter (in)

Parameter	Beschreibung
specifier	InstanceSpecifier to a PortPrototype of a DiagnosticEventInterface.

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_DM_00647
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_00647@rel:R25-11#35a8a338
Content hash: 35a8a338
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00647

Status: valid/unmigrated Version: rel:R25-11#5add1f87 Versionshistorie & Revisions (1 transition, 8 revision)

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/SWS_DM_00647@rel:R25-11#5add1f87

Recorded Revisions (8):

R25-11rel:R25-11#f0666d8e2026-09-30
R19-11rel:R19-11#3c89d7ee2026-10-14
R20-11rel:R20-11#870e61ce2026-10-14
R21-11rel:R21-11#f7c5ed1f2026-10-14
R22-11rel:R22-11#8c18fb3e2026-10-14
R23-11rel:R23-11#f694eb632026-10-14
R24-11rel:R24-11#51cd865b2026-10-14
R25-11rel:R25-11#5add1f872026-10-14 active

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

函数 Event [SWS_DM_01681] Upstream: RS_AP_00147

Event (Event &)=delete;

Event shall be a single not copy-able instance.

Header-Datei	#include "ara/diag/event.h"
Scope	class ara::diag::Event

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_DM_01681
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_01681@rel:R25-11#388d7919
Content hash: 388d7919
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01681

Status: valid/unmigrated Version: rel:R25-11#99c774ff Versionshistorie & Revisions (1 transition, 4 revision)

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/SWS_DM_01681@rel:R25-11#99c774ff

Recorded Revisions (4):

R25-11rel:R25-11#04d5b97d2026-09-30
R23-11rel:R23-11#43b1f1382026-10-14
R24-11rel:R24-11#99c774ff2026-10-14
R25-11rel:R25-11#99c774ff2026-10-14 active

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

函数 Event [SWS_DM_01682] Upstream: RS_AP_00147

Event (Event &&) noexcept=delete;

Move constructor of Event.

Header-Datei	#include "ara/diag/event.h"
Scope	class ara::diag::Event

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_DM_01682
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_01682@rel:R25-11#205c72c1
Content hash: 205c72c1
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01682

Status: valid/unmigrated Version: rel:R25-11#65729748 Versionshistorie & Revisions (1 transition, 4 revision)

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/SWS_DM_01682@rel:R25-11#65729748

Recorded Revisions (4):

R25-11rel:R25-11#8addd59c2026-09-30
R23-11rel:R23-11#30e0773c2026-10-14
R24-11rel:R24-11#657297482026-10-14
R25-11rel:R25-11#657297482026-10-14 active

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

函数 GetDTCNumber [SWS_DM_00653] Upstream: RS_Diag_04201, RS_AP_00139, RS_AP_00119

ara::core::Future< std::uint32_t > GetDTCNumber (DTCFormatType dtc Format) noexcept;

Returns the DTC number related to this event instance.

Header-Datei	#include "ara/diag/event.h"
Scope	class ara::diag::Event
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe

Parameter (in)

Parameter	Beschreibung
dtcFormat	Define the DTC format for the return value.

Rückgabewert

Typ	Beschreibung
ara::core::Future<std::uint32_t >	Return the DTC number in respective DTC format.

Fehler

Fehlercode	Beschreibung
DiagErrc::kNoSuchDTC	rollback_semantics No mapped DTC exits for the requested event.
DiagErrc::kServiceNotAvailable	rollback_semantics The call cannot be executed, because essential DM functionality is currently not available.

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_DM_00653
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_00653@rel:R25-11#b653b4e9
Content hash: b653b4e9
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00653

Status: valid/unmigrated Version: rel:R25-11#5e084285 Versionshistorie & Revisions (1 transition, 8 revision)

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/SWS_DM_00653@rel:R25-11#5e084285

Recorded Revisions (8):

R25-11rel:R25-11#c154a4692026-09-30
R19-11rel:R19-11#5dafafb22026-10-14
R20-11rel:R20-11#bf458cb22026-10-14
R21-11rel:R21-11#06484d962026-10-14
R22-11rel:R22-11#8f25efce2026-10-14
R23-11rel:R23-11#481fbbe32026-10-14
R24-11rel:R24-11#07fccb8e2026-10-14
R25-11rel:R25-11#5e0842852026-10-14 active

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

函数 GetDebouncingStatus [SWS_DM_00654] Upstream: RS_Diag_04068, RS_Diag_04225, RS_AP_00139

ara::core::Future< DebouncingState > GetDebouncingStatus () noexcept;

Get the current debouncing status.

Header-Datei	#include "ara/diag/event.h"
Scope	class ara::diag::Event
Exception-Sicherheit	exception safe
Thread-Sicherheit	not thread-safe

Rückgabewert

Typ	Beschreibung
ara::core::Future<DebouncingState >	Return the current debouncing state of this event.

Fehler

Fehlercode	Beschreibung
DiagErrc::kServiceNotAvailable	rollback_semantics The call cannot be executed, because essential DM functionality is currently not available.

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_DM_00654
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_00654@rel:R25-11#c77be195
Content hash: c77be195
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00654

Status: valid/unmigrated Version: rel:R25-11#8bddb1d0 Versionshistorie & Revisions (1 transition, 8 revision)

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/SWS_DM_00654@rel:R25-11#8bddb1d0

Recorded Revisions (8):

R25-11rel:R25-11#aa2d0fb82026-09-30
R19-11rel:R19-11#343c856a2026-10-14
R20-11rel:R20-11#76fa6fa62026-10-14
R21-11rel:R21-11#76fa6fa62026-10-14
R22-11rel:R22-11#b0bcfa5d2026-10-14
R23-11rel:R23-11#773a565b2026-10-14
R24-11rel:R24-11#58de85e42026-10-14
R25-11rel:R25-11#8bddb1d02026-10-14 active

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

函数 GetEventStatus [SWS_DM_00649] Upstream: RS_Diag_04151, RS_AP_00139

ara::core::Future< EventStatusByte > GetEventStatus () noexcept;

Returns the current diagnostic event status.

Header-Datei	#include "ara/diag/event.h"
Scope	class ara::diag::Event
Exception-Sicherheit	exception safe
Thread-Sicherheit	not thread-safe

Rückgabewert

Typ	Beschreibung
ara::core::Future< EventStatusByte >	Return the current diagnostic event status

Fehler

Fehlercode	Beschreibung
DiagErrc::kServiceNotAvailable	rollback_semantics The call cannot be executed, because essential DM functionality is currently not available.

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_DM_00649
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_00649@rel:R25-11#9c757d73
Content hash: 9c757d73
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00649

Status: valid/unmigrated Version: rel:R25-11#88b46805 Versionshistorie & Revisions (1 transition, 8 revision)

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/SWS_DM_00649@rel:R25-11#88b46805

Recorded Revisions (8):

R25-11rel:R25-11#73c9caf02026-09-30
R19-11rel:R19-11#ac7535d32026-10-14
R20-11rel:R20-11#aa687a9f2026-10-14
R21-11rel:R21-11#aa687a9f2026-10-14
R22-11rel:R22-11#9ace322d2026-10-14
R23-11rel:R23-11#09d412822026-10-14
R24-11rel:R24-11#c1f9b0482026-10-14
R25-11rel:R25-11#88b468052026-10-14 active

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

函数 GetFaultDetectionCounter [SWS_DM_00656] Upstream: RS_Diag_04068, RS_AP_00139

ara::core::Future< std::int8_t > GetFaultDetectionCounter () noexcept;

Returns the current value of the Fault Detection Counter (FDC) of this event.

Header-Datei	#include "ara/diag/event.h"
Scope	class ara::diag::Event
Exception-Sicherheit	exception safe
Thread-Sicherheit	not thread-safe

Rückgabewert

Typ	Beschreibung
ara::core::Future<std::int8_t >	Returns the current FaultDetectionCounter value.

Fehler

Fehlercode	Beschreibung
DiagErrc::kServiceNotAvailable	rollback_semantics The call cannot be executed, because essential DM functionality is currently not available.

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_DM_00656
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_00656@rel:R25-11#e1b694de
Content hash: e1b694de
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00656

Status: valid/unmigrated Version: rel:R25-11#4907132c Versionshistorie & Revisions (1 transition, 8 revision)

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/SWS_DM_00656@rel:R25-11#4907132c

Recorded Revisions (8):

R25-11rel:R25-11#94f917742026-09-30
R19-11rel:R19-11#f9f594e72026-10-14
R20-11rel:R20-11#57d52b342026-10-14
R21-11rel:R21-11#678c683c2026-10-14
R22-11rel:R22-11#845aefab2026-10-14
R23-11rel:R23-11#f314b0512026-10-14
R24-11rel:R24-11#b946e5e42026-10-14
R25-11rel:R25-11#4907132c2026-10-14 active

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

函数 GetTestComplete [SWS_DM_00655] Upstream: RS_Diag_04151, RS_AP_00139

ara::core::Future< bool > GetTestComplete () noexcept;

Get the status if the event has matured to test completed (corresponds to FDC = -128 or FDC = 127).

Header-Datei	#include "ara/diag/event.h"
Scope	class ara::diag::Event
Exception-Sicherheit	exception safe
Thread-Sicherheit	not thread-safe

Rückgabewert

Typ	Beschreibung
ara::core::Future< bool >	Return the current test_completed-state of this event. TRUE, if FDC = -128 or FDC = 127; FALSE in all other cases.

Fehler

Fehlercode	Beschreibung
DiagErrc::kServiceNotAvailable	rollback_semantics The call cannot be executed, because essential DM functionality is currently not available.

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_DM_00655
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_00655@rel:R25-11#baf3e594
Content hash: baf3e594
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00655

Status: valid/unmigrated Version: rel:R25-11#567ebe83 Versionshistorie & Revisions (1 transition, 8 revision)

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/SWS_DM_00655@rel:R25-11#567ebe83

Recorded Revisions (8):

R25-11rel:R25-11#2124e8272026-09-30
R19-11rel:R19-11#3073277b2026-10-14
R20-11rel:R20-11#2be275092026-10-14
R21-11rel:R21-11#1d60449a2026-10-14
R22-11rel:R22-11#5d7ba70b2026-10-14
R23-11rel:R23-11#6d14f8702026-10-14
R24-11rel:R24-11#1273d1452026-10-14
R25-11rel:R25-11#567ebe832026-10-14 active

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

函数 SetEventStatusChangedNotifier [SWS_DM_00650] Upstream: RS_Diag_04183, RS_AP_00139

ara::core::Result< void > SetEventStatusChangedNotifier (EventStatus ByteNotifier notifier) noexcept;

Register a notifier function which is called if a diagnostic event is changed. A consecutive call of this method will overwrite the previous registered notifier.

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

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

Adaptive Application 通过类 ara::diag::Event（头文件 ara/diag/event.h）的方法 [SWS_DM_00650] 注册类型为 EventStatusByteNotifier 的回调函数。成功注册后，Diagnostic Management (DM) 会在关联诊断事件的每次状态更改时调用此通知程序 [SWS_DM_01029]。连续调用该方法将覆盖先前注册的通知程序 [SWS_DM_00650]。该函数具有签名 ara::core::Result<void> SetEventStatusChangedNotifier(EventStatusByteNotifier notifier) noexcept，并在成功时返回空结果 [SWS_DM_00650]。

如果在处理过程中发生错误，该方法将返回错误码 DiagErrc::kInvalidArgument [SWS_DM_00650]。虽然该接口被声明为异常安全（exception safe），但显式被视为非线程安全（not thread-safe）[SWS_DM_00650]。Interpretation：对同一实例的并发访问必须在应用程序端进行同步；因此，可能最好在应用程序的初始化阶段进行注册。问题 Q-d8ed099eaed6b197 (未决)

从功能上讲，正如 SWS Diagnostics §7.3.4.1.7 “Event status change notifications” 中所述，通知程序构成了通过 GetEventStatus [SWS_DM_00886] 进行同步状态查询的异步对应项。对于集合实例，类 ara::diag::MultipleEvent 提供了相应的方法 [SWS_DM_01708]，并额外传递一个 EventHandleType SWS Diagnostics §8.43.2.1.3.5 “SetEventStatusChangedNotifier”。

本使用说明基于 AUTOSAR Adaptive R25-11 规范自动生成。

实现者指南即将推出（复杂度 I2）

Header-Datei	#include "ara/diag/event.h"
Scope	class ara::diag::Event
Exception-Sicherheit	exception safe
Thread-Sicherheit	not thread-safe

Parameter (in)

Parameter	Beschreibung
notifier	The function to be called if a diagnostic event is changed.

Rückgabewert

Typ	Beschreibung
ara::core::Result< void >	Returns nothing or an error.

Fehler

Fehlercode	Beschreibung
DiagErrc::kInvalidArgument	rollback_semantics e.g. kPreFailed with internal debouncing

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_DM_00650
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_00650@rel:R25-11#99138427
Content hash: 99138427
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00650

Status: valid/unmigrated Version: rel:R25-11#2c7ca3fc Versionshistorie & Revisions (1 transition, 8 revision)

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/SWS_DM_00650@rel:R25-11#2c7ca3fc

Recorded Revisions (8):

R25-11rel:R25-11#a0cbc3d82026-09-30
R19-11rel:R19-11#dc5182fc2026-10-14
R20-11rel:R20-11#23d7e9432026-10-14
R21-11rel:R21-11#dbbe3d9e2026-10-14
R22-11rel:R22-11#ed3ac0b02026-10-14
R23-11rel:R23-11#6fbd522f2026-10-14
R24-11rel:R24-11#019f01af2026-10-14
R25-11rel:R25-11#2c7ca3fc2026-10-14 active

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

函数 operator= [SWS_DM_01679] Upstream: RS_AP_00147

Event & operator= (Event &)=delete;

Event shall be a single not assign-able instance.

Header-Datei	#include "ara/diag/event.h"
Scope	class ara::diag::Event

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_DM_01679
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_01679@rel:R25-11#4d6e44cd
Content hash: 4d6e44cd
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01679

Status: valid/unmigrated Version: rel:R25-11#10ef80b0 Versionshistorie & Revisions (1 transition, 4 revision)

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/SWS_DM_01679@rel:R25-11#10ef80b0

Recorded Revisions (4):

R25-11rel:R25-11#2fa03c0a2026-09-30
R23-11rel:R23-11#fccd65ac2026-10-14
R24-11rel:R24-11#10abe0b52026-10-14
R25-11rel:R25-11#10ef80b02026-10-14 active

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

函数 operator= [SWS_DM_01680] Upstream: RS_AP_00147

Event & operator= (Event &&)=delete;

Move assignment operator of Event.

Header-Datei	#include "ara/diag/event.h"
Scope	class ara::diag::Event

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_DM_01680
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_01680@rel:R25-11#40120e6a
Content hash: 40120e6a
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01680

Status: valid/unmigrated Version: rel:R25-11#c25e65da Versionshistorie & Revisions (1 transition, 4 revision)

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/SWS_DM_01680@rel:R25-11#c25e65da

Recorded Revisions (4):

R25-11rel:R25-11#986c114c2026-09-30
R23-11rel:R23-11#89bb7bca2026-10-14
R24-11rel:R24-11#c25e65da2026-10-14
R25-11rel:R25-11#c25e65da2026-10-14 active

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

函数 ~Event [SWS_DM_00648] Upstream: RS_Diag_04151, RS_AP_00134

~Event () noexcept;

Destructor of class Event.

Header-Datei	#include "ara/diag/event.h"
Scope	class ara::diag::Event
Exception-Sicherheit	exception safe
Thread-Sicherheit	not thread-safe

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_DM_00648
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_00648@rel:R25-11#bd72a17e
Content hash: bd72a17e
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00648

Status: valid/unmigrated Version: rel:R25-11#a0bd8c99 Versionshistorie & Revisions (1 transition, 8 revision)

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/SWS_DM_00648@rel:R25-11#a0bd8c99

Recorded Revisions (8):

R25-11rel:R25-11#c8ade5942026-09-30
R19-11rel:R19-11#484b371b2026-10-14
R20-11rel:R20-11#98c042472026-10-14
R21-11rel:R21-11#4af04e862026-10-14
R22-11rel:R22-11#f870d3302026-10-14
R23-11rel:R23-11#9789d55a2026-10-14
R24-11rel:R24-11#bd9345702026-10-14
R25-11rel:R25-11#a0bd8c992026-10-14 active

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::diag::Event

用户指南人工智能生成

上下文

生命周期

使用路径

错误场景

成员图

构造函数和析构函数

方法

运算符

类图

详细视图

构造函数和析构函数

方法

运算符

方法文档

函数 Event [SWS_DM_00647] Upstream: RS_Diag_04151, RS_AP_00137, RS_AP_00170, RS_AP_00171, RS_AP_00172, RS_AP_00173

Parameter (in)

Recorded Revisions (8):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

函数 Event [SWS_DM_01681] Upstream: RS_AP_00147

Recorded Revisions (4):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

函数 Event [SWS_DM_01682] Upstream: RS_AP_00147

Recorded Revisions (4):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

函数 GetDTCNumber [SWS_DM_00653] Upstream: RS_Diag_04201, RS_AP_00139, RS_AP_00119

Parameter (in)

Rückgabewert

Fehler

Recorded Revisions (8):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

函数 GetDebouncingStatus [SWS_DM_00654] Upstream: RS_Diag_04068, RS_Diag_04225, RS_AP_00139

Rückgabewert

Fehler

Recorded Revisions (8):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

函数 GetEventStatus [SWS_DM_00649] Upstream: RS_Diag_04151, RS_AP_00139

Rückgabewert

Fehler

Recorded Revisions (8):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

函数 GetFaultDetectionCounter [SWS_DM_00656] Upstream: RS_Diag_04068, RS_AP_00139

Rückgabewert

Fehler

Recorded Revisions (8):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

函数 GetTestComplete [SWS_DM_00655] Upstream: RS_Diag_04151, RS_AP_00139

Rückgabewert

Fehler

Recorded Revisions (8):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

函数 SetEventStatusChangedNotifier [SWS_DM_00650] Upstream: RS_Diag_04183, RS_AP_00139

Parameter (in)

Rückgabewert

Fehler

Recorded Revisions (8):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

函数 operator= [SWS_DM_01679] Upstream: RS_AP_00147

Recorded Revisions (4):

Requirement Text as-of this release:

Curation Decisions: