DEENESPTFRRUARHIKOZHNL

类 <DataIdentifier-Namespace>::<DataIdentifierInterface>

[SWS_DM_00601] Upstream: RS_Diag_04169

class <DataIdentifierInterface> {...};

DiagnosticDataIdentifierInterface class

Header-Datei#include "<DataIdentifierDirectoryPath>/<DataIdentifierShortname>.h"
Forwarding-Header#include "<DataIdentifierDirectoryPath>/<DataIdentifierShortname>/<DataIdentifierShortname>_ fwd.h"
Scopenamespace <DataIdentifier-Namespace>

用户指南人工智能生成

允许应用程序响应特定数据标识符的诊断读取和写入请求。
AI 生成 未审核 模型： gemini-3.8-flash-medium · 推理强度： medium · 温度： 不可控 · 提示词： 7fb3639fc276 来源 未决问题（1）
译自德文指南gemini-3.8-flash-low · 2026-10-13 · 德文原文

允许应用程序响应特定数据标识符的诊断读取和写入请求。

接口 <DataIdentifier-Namespace>::<DataIdentifierInterface> 使自适应应用程序能够向 Diagnostic Management [SWS_DM_00585] 提供模型特定的诊断数据标识符。创建后，Offer() 会启用请求转发，这些请求通过 Read() 或 Write() 进行异步处理，并在需要时使用 UDS 错误代码进行响应 [SWS_DM_00599] [SWS_DM_00640]。由于该实例既不可拷贝也不可移动，因此在销毁前通过 StopOffer() 显式终止服务 [SWS_DM_01665] [SWS_DM_00600]。

上下文

C++ 类 <DataIdentifier-Namespace>::<DataIdentifierInterface> 用作 Adaptive Platform SWS Diagnostics 第68页 的模块 diag 中诊断数据标识符（Data Identifiers，DID）的功能接口。它将自适应应用层与中央 Diagnostic Management (DM) 连接起来。Diagnostic Management 接收外部诊断请求并将其转发给已注册的实例 [SWS_DM_00599]。应用软件通过派生类提供具体实现，以通过读取或写入操作查询或更新数据内容 [SWS_DM_00640] [SWS_DM_00598]。

生命周期

通过带参数的构造函数进行创建，传入 ara::core::InstanceSpecifier 和并发模式 ara::diag::ConcurrencyType [SWS_DM_00585]。后者指定是否允许对实例的调用进行并发（kConcurrent）或非并发（kNotConcurrent）处理 [SWS_DM_00585]。由于实例与其模型配置紧密绑定，因此拷贝构造函数和移动构造函数均被显式删除 [SWS_DM_01665] [SWS_DM_01666]；拷贝和移动赋值运算符同样如此 [SWS_DM_01663] [SWS_DM_01664]。

实例化后，接口处于非活动状态。只有通过调用 Offer()，才会激活 Diagnostic Management 对诊断请求的转发 [SWS_DM_00599]。方法 StopOffer() 再次终止此转发 [SWS_DM_00600]。通过虚析构函数 [SWS_DM_00586] 释放资源。解释：在销毁对象之前，通常推测应调用 StopOffer()，以便有序阻止 DM 未决或新传入的转发。 问题 Q-3710c559625978c9 (未决)

使用路径

常规流程包括实例化、服务注册、异步请求处理以及随后的停用：

  1. 实例化：应用程序通过指定 InstanceSpecifier 和所需的 ConcurrencyType 设置来创建接口实例 [SWS_DM_00585]。
  2. 服务启用：应用程序调用 Offer()，从而允许 Diagnostic Management 将请求分发给该处理程序 [SWS_DM_00599]。
  3. 请求处理：在读取访问时，DM 调用纯虚方法 Read() [SWS_DM_00640]，在写入访问时调用 Write() [SWS_DM_00598]。应用程序可以通过传入的 cancellationHandler 监视取消事件。结果以异步方式作为 ara::core::Future 提供，在 Read() 时它包含带有输出数据的 ReadOutput 对象 [SWS_DM_00579] [SWS_DM_00640] [SWS_DM_80013]。
  4. 服务终止：在销毁对象 [SWS_DM_00586] 之前，通过调用 StopOffer() 停止转发 [SWS_DM_00600]。
数据标识符请求的提供与处理流程应用DataIdentifierInterface诊断管理Konstruktor(instanceSpec, concurrencyType)Offer()Weiterleitung aktivierenResult<void> (Erfolg)Use Case: Diagnoseanfrage durch DMRead(metaInfo, cancellationHandler)Future<ReadOutput>Use Case: 停用服务与拆卸StopOffer()Weiterleitung deaktivieren~<DataIdentifierInterface>()

时序图：DID 提供的典型流程，从初始化到异步请求响应直至停用。来源：[SWS_DM_00585]，[SWS_DM_00599]，[SWS_DM_00640]，[SWS_DM_00600]，[SWS_DM_00586]。

错误场景

早在对象创建时，建模错误就可能导致违规：如果缺少端口或进程关联，则会出现 InstanceSpecifierMappingIntegrityViolation、PortInterfaceMappingViolation 或 ProcessMappingViolation [SWS_DM_00585]。如果在同一进程中重用相同的 InstanceSpecifier，框架将报告 InstanceSpecifierAlreadyInUseViolation [SWS_DM_00585]。

如果在服务已提供的情况下调用 Offer()，则调用失败并通过 ara::core::Result 返回错误代码 DiagOfferErrc::kAlreadyOffered [SWS_DM_00599]。如果 Read() 或 Write() 的执行失败，实现将使用 ISO 14229-1 UDS 错误代码（DiagUdsNrcErrc）或应用程序特定的 ApApplicationError 在 Future 中异步传输错误 [SWS_DM_00640] [SWS_DM_00598]。在异常安全性方面，构造函数和处理方法被指定为 exception safe [SWS_DM_00585] [SWS_DM_00599] [SWS_DM_00640] [SWS_DM_00598]，而析构函数未被标明为 exception safe [SWS_DM_00586]。

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

成员图

方法

6
<DataIdentifierInterface>OfferReadStopOfferWrite~<DataIdentifierInterface>

运算符

1
operator=

常量

1
<DataIdentifierOutArg>

嵌套类型

1
<DataIdentifier>ReadOutput

类图

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

G n_DataIdentifier_Namespace____DataIdentifierInterface_960 <DataIdentifierInterface> + <DataIdentifierOutArg> + Offer() + Read() + StopOffer() + Write() + operator=() + <DataIdentifierInterface>() + ~<DataIdentifierInterface>()

详细视图

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

方法

<DataIdentifierInterface> 函数 3

Construct a DataIdentifier from an ara::core::InstanceSpecifier

重载 <DataIdentifierInterface> 3
<DataIdentifierInterface1> (ara::core::InstanceSpecifier instanceSpec, ara::diag::ConcurrencyType concurrencyType) noexcept; SWS_DM_00585
<DataIdentifierInterface2> (const <DataIdentifierInterface2> &other)=delete; SWS_DM_01665
<DataIdentifierInterface4> ( <DataIdentifierInterface4> &&other)=delete; SWS_DM_01666
Offer 函数

This Offer will enable the DM to forward request messages to this handler

ara::core::Result< void > Offer () noexcept;
Read 函数

Provision of a reading DataIdentifier (DiagnosticDataIdentifierInterface in the role read).

virtual ara::core::Future< <DataIdentifier>ReadOutput > Read (const ara::diag::MetaInfo &metaInfo, ara::diag::CancellationHandler cancellationHandler) noexcept=0;
StopOffer 函数

This StopOffer will disable the forwarding of request messages from DM

void StopOffer () noexcept;
Write 函数

Provision of a writing DataIdentifier (DiagnosticDataIdentifierInterface in the role write).

virtual ara::core::Future< void > Write ( {<data-identifier-in-arg-derived-type-0toN>} {<data-identifier-in-arg-symbol-0toN>}, const ara::diag::MetaInfo &metaInfo, ara::diag::CancellationHandler cancellationHandler) noexcept=0;
~<DataIdentifierInterface> 函数

Destruction of a DataIdentifier

virtual ~<DataIdentifierInterface6> ();

运算符

operator= 函数 2

Copy assignment constructor deletion

重载 = 2
<DataIdentifierInterface3> & operator= (const <DataIdentifierInterface3> &other)=delete; SWS_DM_01663
<DataIdentifierInterface5> & operator= ( <DataIdentifierInterface5> &&other)=delete; SWS_DM_01664

常量

<DataIdentifierOutArg> 变量

Member declaration representing an out argument in an Output.

<DataIdentifierOutArgType> <DataIdentifierOutArg>;

嵌套类型

<DataIdentifier>ReadOutput 类

方法文档

函数 <DataIdentifierInterface> [SWS_DM_00585] Upstream: RS_AP_00137, RS_AP_00170, RS_AP_00171, RS_AP_00172, RS_AP_00173

<DataIdentifierInterface1> (ara::core::InstanceSpecifier instanceSpec, ara::diag::ConcurrencyType concurrencyType) noexcept;

Construct a DataIdentifier from an ara::core::InstanceSpecifier

AI 生成 未审核 模型： gemini-3.8-flash-medium · 推理强度： medium · 温度： 不可控 · 提示词： c2e49b8d93ab 来源 未决问题（1）
译自德文指南gemini-3.8-flash-low · 2026-10-13 · 德文原文

使用

构造函数<DataIdentifierInterface>用于从ara::core::InstanceSpecifier实例化数据标识符[SWS_DM_00585]。声明在命名空间<DataIdentifier-Namespace>内通过头文件#include "<DataIdentifierDirectoryPath>/<DataIdentifierShortname>.h"进行[SWS_DM_00585]。同步调用被指定为noexcept，并具有“exception safe”以及“thread-safe”属性[SWS_DM_00585]。

该函数接收以下传入参数[SWS_DM_00585]：

  • instanceSpec（ara::core::InstanceSpecifier）：服务的具体实例的标识符[SWS_DM_00585]。
  • concurrencyType（ara::diag::ConcurrencyType）：确定接口是以带有kConcurrent的线程安全方式运行，还是以带有kNotConcurrent的非线程安全方式运行[SWS_DM_00585]。

错误处理和建模规则

该函数不提供返回值且不抛出异常。配置或建模中的错误将导致定义的 Violations [SWS_DM_00585]：

  • InstanceSpecifierMappingIntegrityViolation：instanceSpec在 Executable 上下文中无法解析或未指向PortPrototype[SWS_DM_00585]。
  • PortInterfaceMappingViolation：由DiagnosticDataIdentifierInterface类型化的PortPrototype未被DiagnosticDataPortMapping引用[SWS_DM_00585]。
  • ProcessMappingViolation：对于实例引用，当前运行时进程不存在匹配的建模进程[SWS_DM_00585]。
  • InstanceSpecifierAlreadyInUseViolation：构造函数被使用已在当前进程中使用的instanceSpec调用[SWS_DM_00585]。

Interpretation：由于该函数声明为noexcept，检测到的 Violations 大概会在框架内部作为关键初始化错误进行处理。 问题 Q-8616025446bf33f2 (未决)

并发性

构造函数本身以线程安全的方式实现[SWS_DM_00585]。通过参数concurrencyType控制是否允许对实例的后续接口调用并发进行[SWS_DM_00585]。

本使用说明基于规范自动生成。

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

Header-Datei#include "<DataIdentifierDirectoryPath>/<DataIdentifierShortname>.h"
Scopeclass <DataIdentifier-Namespace>::<DataIdentifierInterface>
Exception-Sicherheitexception safe
Thread-Sicherheitthread-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 typed by a pingViolation DiagnosticDataIdentifierInterface needs to be referenced by a DiagnosticDataPortMapping. 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)

ParameterBeschreibung
instanceSpecThe specifier of a specific instance of a service.
concurrencyTypeSpecifies if the interface is implemented as thread safe ( kConcurrent) or non-thread safe (kNotConcurrent)..

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

Record
AUTOSAR/AP/record/SWS_DM_00585
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00585@rel:R25-11#57ff68fd
Content hash
57ff68fd
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00585
Status: valid/unmigrated Version: rel:R25-11#4e8f5fe5 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_00585@rel:R25-11#4e8f5fe5
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#424df92c2026-09-30
  • R19-11rel:R19-11#420e87cb2026-10-14
  • R20-11rel:R20-11#6d8ab4df2026-10-14
  • R21-11rel:R21-11#c7e8234c2026-10-14
  • R22-11rel:R22-11#5168b3b22026-10-14
  • R23-11rel:R23-11#c7617fcf2026-10-14
  • R24-11rel:R24-11#9629e2942026-10-14
  • R25-11rel:R25-11#4e8f5fe52026-10-14 active
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

函数 <DataIdentifierInterface> [SWS_DM_01665] Upstream: RS_AP_00147

<DataIdentifierInterface2> (const <DataIdentifierInterface2> &other)=delete;

Copy constructor deletion

Header-Datei#include "<DataIdentifierDirectoryPath>/<DataIdentifierShortname>.h"
Scopeclass <DataIdentifier-Namespace>::<DataIdentifierInterface>

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

Record
AUTOSAR/AP/record/SWS_DM_01665
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01665@rel:R25-11#80ac631f
Content hash
80ac631f
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01665
Status: valid/unmigrated Version: rel:R25-11#d2f9729a 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_01665@rel:R25-11#d2f9729a
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#ae00ab682026-09-30
  • R23-11rel:R23-11#c667bc4b2026-10-14
  • R24-11rel:R24-11#fa08505b2026-10-14
  • R25-11rel:R25-11#d2f9729a2026-10-14 active
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

函数 <DataIdentifierInterface> [SWS_DM_01666] Upstream: RS_AP_00147

<DataIdentifierInterface4> ( <DataIdentifierInterface4> &&other)=delete;

Move constructor

Header-Datei#include "<DataIdentifierDirectoryPath>/<DataIdentifierShortname>.h"
Scopeclass <DataIdentifier-Namespace>::<DataIdentifierInterface>

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

Record
AUTOSAR/AP/record/SWS_DM_01666
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01666@rel:R25-11#e7571519
Content hash
e7571519
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01666
Status: valid/unmigrated Version: rel:R25-11#3ab93d5e 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_01666@rel:R25-11#3ab93d5e
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#37eed7f82026-09-30
  • R23-11rel:R23-11#eaf209332026-10-14
  • R24-11rel:R24-11#8925cf032026-10-14
  • R25-11rel:R25-11#3ab93d5e2026-10-14 active
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

函数 Offer [SWS_DM_00599] Upstream: RS_AP_00119, RS_AP_00139, RS_Diag_04169, RS_Diag_04224

ara::core::Result< void > Offer () noexcept;

This Offer will enable the DM to forward request messages to this handler

AI 生成 未审核 模型： gemini-3.8-flash-medium · 推理强度： medium · 温度： 不可控 · 提示词： ebb465f1e58b 来源 未决问题（1）
译自德文指南gemini-3.8-flash-low · 2026-10-13 · 德文原文

用法与调用上下文

同步方法 Offer() 允许 Diagnostic Management (DM) 将传入的诊断请求转发给 <DataIdentifierInterface> 的相应实例（[SWS_DM_00599]）。该函数不接收输入参数，并被指定为 noexcept（[SWS_DM_00599]）。解释：该调用通常应在应用程序的初始化阶段进行，因为 DM 在提供之前无法传递请求。 问题 Q-4ba81ff234a09f46 (未决)

错误处理与返回值

ara::core::Result<void> 用作返回值（[SWS_DM_00599]）。如果注册成功，则结果不包含值。如果处理程序先前已被提供，则调用失败并返回具有回滚语义的错误码 DiagOfferErrc::kAlreadyOffered（[SWS_DM_00599]；参见 [SWS_DM_00514]）。

并发性与限制

该函数确保异常安全（exception safe），但明确被指定为非线程安全（not thread-safe）（[SWS_DM_00599]）。同一实例上的并行调用必须由应用程序进行同步。

相互作用

提供模式符合 DM 中统一的激活方式：类似的 Offer() 方法存在于通用标识符（[SWS_DM_00638]）、数据元素（[SWS_DM_00597]）、例程（[SWS_DM_00557]、[SWS_DM_00594]）和 DoIP 服务（[SWS_DM_00725]、[SWS_DM_00735]）。只要 Offer() 尚未执行，DM 就不会向处理程序转发任何请求，并且对于 DoIP 服务使用默认值进行响应（[SWS_DM_01525]、[SWS_DM_01527]）。

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

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

Header-Datei#include "<DataIdentifierDirectoryPath>/<DataIdentifierShortname>.h"
Scopeclass <DataIdentifier-Namespace>::<DataIdentifierInterface>
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe

Rückgabewert

TypBeschreibung
ara::core::Result< void >• If successful: an ara::core::Result containing a ara:: core::Result::value_type • If unsuccessful: an ara::core::Result containing an ara:: core::Result::error_type i.e. a corresponding ara:: diag::DiagOfferErrc

Fehler

FehlercodeBeschreibung
DiagOfferErrc::kAlreadyOfferedrollback_semantics The service is already offered.

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

Record
AUTOSAR/AP/record/SWS_DM_00599
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00599@rel:R25-11#baa2a088
Content hash
baa2a088
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00599
Status: valid/unmigrated Version: rel:R25-11#b1695320 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_00599@rel:R25-11#b1695320
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#8a80b11d2026-09-30
  • R19-11rel:R19-11#ca894da82026-10-14
  • R20-11rel:R20-11#cb4154752026-10-14
  • R21-11rel:R21-11#1465258e2026-10-14
  • R22-11rel:R22-11#cb17bfe82026-10-14
  • R23-11rel:R23-11#209914022026-10-14
  • R24-11rel:R24-11#713a92052026-10-14
  • R25-11rel:R25-11#b16953202026-10-14 active
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

函数 Read [SWS_DM_00640] Upstream: RS_AP_00114, RS_AP_00127, RS_AP_00128, RS_AP_00138

virtual ara::core::Future< <DataIdentifier>ReadOutput > Read (const ara::diag::MetaInfo &metaInfo, ara::diag::CancellationHandler cancellationHandler) noexcept=0;

Provision of a reading DataIdentifier (DiagnosticDataIdentifierInterface in the role read).

AI 生成 未审核 模型： gemini-3.8-flash-medium · 推理强度： medium · 温度： 不可控 · 提示词： 85f20519a648 来源
译自德文指南gemini-3.8-flash-low · 2026-10-13 · 德文原文

使用

方法 Read 用于在 DiagnosticDataIdentifierInterface 的读取角色中提供诊断数据标识符（DataIdentifier）的数据 [SWS_DM_00640]。在发生外部诊断请求时，由 Diagnostic Manager (DM) 异步进行调用 AUTOSAR_AP_SWS_Diagnostics 第143页 §7.3.2.6.1 “NRCs created by application”。作为参数传递 metaInfo 以评估请求属性，并传递 cancellationHandler [SWS_DM_00640]。处理应用程序可以通过 cancellationHandler.IsCanceled() 查询取消状态，或者在会话提前中止的情况下通过 cancellationHandler.SetNotifier() 注册回调 [SWS_DM_00640]。结果异步作为带有 ReadOutput 对象的 ara::core::Future 返回 [SWS_DM_00640]，[SWS_DM_00579]。

错误处理

该函数被指定为 exception safe，且不得向外部传播异常 [SWS_DM_00640]。如果在数据获取过程中发生错误，应用程序在 ara::core::Future 中返回否定返回值，形式为匹配的 UDS 错误码（通过 DiagUdsNrcErrc 符合 ISO 14229-1 的 NRC）或 ApApplicationError [SWS_DM_00640]，AUTOSAR_AP_SWS_Diagnostics 第143页 §7.3.2.6.1 “NRCs created by application”。

并发性与交互

该接口函数默认为 not thread-safe [SWS_DM_00640]。Diagnostic Manager 对读取和写入访问的并发执行通过类型 ara::diag::DataIdentifierConcurrencyType::readWrite 进行调节，该类型默认预设为 kNotConcurrent [SWS_DM_00939]。相关的读取操作针对单个数据元素通过 DiagnosticDataElementInterface [SWS_DM_00596] 存在，且针对通用标识符通过 [SWS_DM_00636] 存在。

本文由 AI 基于 AUTOSAR Adaptive R25-11 规范生成。

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

Header-Datei#include "<DataIdentifierDirectoryPath>/<DataIdentifierShortname>.h"
Scopeclass <DataIdentifier-Namespace>::<DataIdentifierInterface>
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe

Parameter (in)

ParameterBeschreibung
metaInfoMetaInfo of the request.
cancellationHandlerThis parameter is used to • Query the current cancellation status by calling cancellationHandler.IsCanceled. Returns TRUE in case, the current conversation has been cancelled and FALSE otherwise. • Register a notifier function by calling cancellationHandler.SetNotifier. The registered notifier is called if the current conversation is cancelled.

Rückgabewert

TypBeschreibung
ara::core::Future< {<data-identifier-name>}ReadOutput >• If successful: an ara::core::Future containing a ReadOutput object as per [SWS_DM_00579] • If unsuccessful: an ara::core::Future containing a corresponding DiagUdsNrcErrc or ApApplicationError.

Fehler

FehlercodeBeschreibung
Please use an applicable NRC, as defined in ISO 14229-1, using DiagUdsNrcErrc.

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

Record
AUTOSAR/AP/record/SWS_DM_00640
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00640@rel:R25-11#a725e1bc
Content hash
a725e1bc
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00640
Status: valid/unmigrated Version: rel:R25-11#09d4ff6e 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_00640@rel:R25-11#09d4ff6e
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#2edc90672026-09-30
  • R19-11rel:R19-11#6713bf032026-10-14
  • R20-11rel:R20-11#8a573eb02026-10-14
  • R21-11rel:R21-11#5d209a572026-10-14
  • R22-11rel:R22-11#d59456d32026-10-14
  • R23-11rel:R23-11#d388add12026-10-14
  • R24-11rel:R24-11#05b336912026-10-14
  • R25-11rel:R25-11#09d4ff6e2026-10-14 active
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

函数 StopOffer [SWS_DM_00600] Upstream: RS_Diag_04169

void StopOffer () noexcept;

This StopOffer will disable the forwarding of request messages from DM

AI 生成 未审核 模型： gemini-3.8-flash-medium · 推理强度： medium · 温度： 不可控 · 提示词： 3f19138aee59 来源 未决问题（1）
译自德文指南gemini-3.8-flash-low · 2026-10-13 · 德文原文

方法 StopOffer 卸载 Diagnostic Management (DM) 向具体接口实例转发传入诊断请求的功能 [SWS_DM_00600]。通过此调用，自适应应用程序指示其临时或永久不再准备好处理针对该 DataIdentifier 的请求。

用法与语义

该调用为同步、无参数且不返回返回值 [SWS_DM_00600]。需要包含生成的接口文件 #include "<DataIdentifierDirectoryPath>/<DataIdentifierShortname>.h" 作为头文件 [SWS_DM_00600]。命名遵循从 ara::com 中已知的模式，但代表诊断域的独立接口 AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 “Monitors”。

错误处理与并发

  • 异常安全性：该函数声明为 noexcept 并保证完全的异常安全（exception safe）[SWS_DM_00600]。不会抛出任何异常。
  • 线程安全性：该操作被指定为 not thread-safe [SWS_DM_00600]。必须同步调用，以确保不会对同一接口实例进行并行访问。

相互作用

该行为符合 Diagnostic Management 的统一停用模式，正如针对相关接口（例如例程 [SWS_DM_00558]、通用数据元素 [SWS_DM_00639] 或下载服务 [SWS_DM_00793]）类似定义的那样。成功停用后，从 DM 发往该 DataIdentifier 的传入请求将不再转发给应用程序处理程序 [SWS_DM_00600]；随后 DM 应当会生成相应的否定响应码。 问题 Q-d301740d097f9946 (未决)

此使用说明基于 AUTOSAR AP R25-11 规范的规定。

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

Header-Datei#include "<DataIdentifierDirectoryPath>/<DataIdentifierShortname>.h"
Scopeclass <DataIdentifier-Namespace>::<DataIdentifierInterface>
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_DM_00600
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00600@rel:R25-11#78354b26
Content hash
78354b26
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00600
Status: valid/unmigrated Version: rel:R25-11#06007200 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_00600@rel:R25-11#06007200
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#22b516472026-09-30
  • R19-11rel:R19-11#086a57212026-10-14
  • R20-11rel:R20-11#b9a8e5302026-10-14
  • R21-11rel:R21-11#c2bf51c22026-10-14
  • R22-11rel:R22-11#008226012026-10-14
  • R23-11rel:R23-11#4ba8fcde2026-10-14
  • R24-11rel:R24-11#095120152026-10-14
  • R25-11rel:R25-11#060072002026-10-14 active
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

函数 Write [SWS_DM_00598] Upstream: RS_AP_00114, RS_AP_00127, RS_AP_00128, RS_AP_00138

virtual ara::core::Future< void > Write ( {<data-identifier-in-arg-derived-type-0toN>} {<data-identifier-in-arg-symbol-0toN>}, const ara::diag::MetaInfo &metaInfo, ara::diag::CancellationHandler cancellationHandler) noexcept=0;

Provision of a writing DataIdentifier (DiagnosticDataIdentifierInterface in the role write).

AI 生成 未审核 模型： gemini-3.8-flash-medium · 推理强度： medium · 温度： 不可控 · 提示词： 301e55bffd12 来源
译自德文指南gemini-3.8-flash-low · 2026-10-13 · 德文原文

该接口函数用于在 Write 角色中类型安全地提供写入 DataIdentifier (DID) [SWS_DM_00598]。只要系统支持该 DID 并且成功通过活动诊断会话和安全级别的检查 [SWS_DM_00415] [SWS_DM_00416] [SWS_DM_00417]，Diagnostic Server 实例就会在收到 UDS 服务 0x2E (WriteDataByIdentifier) 的传入诊断请求时调用该函数 [SWS_DM_00186]。与带有原始字节 span 的通用变体 [SWS_DM_00637] 不同，该方法绑定了模型特定类型化的输入参数 [SWS_DM_00598]。

  • 参数：除了生成的输入实参之外，该方法还通过 metaInfo 接收关于请求的元信息以及一个 cancellationHandler [SWS_DM_00598]。通过取消处理程序，应用程序可以通过 IsCanceled 检查会话是否已取消，或者使用 SetNotifier 注册针对取消情况的通知 [SWS_DM_00598]。
  • 返回值和错误处理：执行通过 ara::core::Future<void> 异步进行 [SWS_DM_00598]。成功时，Future 提供类型 void。在发生错误时，必须使用 ara::diag::DiagUdsNrcErrc 返回符合 ISO 14229-1 的相应 UDS NRC 或返回相应的 ApplicationError [SWS_DM_00598]。该函数被声明为异常安全（exception safe）[SWS_DM_00598]。
  • 并发性：该方法被归类为非线程安全（not thread-safe）[SWS_DM_00598]。是否允许通过 Diagnostic Management 并行调用读写访问由 DataIdentifierConcurrencyType 中的配置元素 readWrite 控制 [SWS_DM_00939]。

本使用说明基于 AUTOSAR 规范自动创建。

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

Header-Datei#include "<DataIdentifierDirectoryPath>/<DataIdentifierShortname>.h"
Scopeclass <DataIdentifier-Namespace>::<DataIdentifierInterface>
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe

Parameter (in)

ParameterBeschreibung
{<data-identifier-in-arg-symbol-0toN>}The symbol name of method argument[0..N] in the ordered list of method arguments, with ClientServerOperation. direction == in given by ClientServerOperation. ArgumentDataPrototype[0..N]. shortName
metaInfoMetaInfo of the request.
cancellationHandlerThis parameter is used to • Query the current cancellation status by calling cancellationHandler.IsCanceled. Returns TRUE in case, the current conversation has been cancelled and FALSE otherwise. • Register a notifier function by calling cancellationHandler.SetNotifier. The registered notifier is called if the current conversation is cancelled.

Rückgabewert

TypBeschreibung
ara::core::Future< void >• If successful: an ara::core::Future containing a void. • If unsuccessful: an ara::core::Future containing a corresponding ara::diag::DiagUdsNrcErrc or Ap ApplicationError.

Fehler

FehlercodeBeschreibung
Please use an applicable NRC, as defined in ISO 14229-1, using DiagUdsNrcErrc.

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

Record
AUTOSAR/AP/record/SWS_DM_00598
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00598@rel:R25-11#481aa77c
Content hash
481aa77c
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00598
Status: valid/unmigrated Version: rel:R25-11#bdb87168 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_00598@rel:R25-11#bdb87168
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#72cee5e42026-09-30
  • R19-11rel:R19-11#0d590eb92026-10-14
  • R20-11rel:R20-11#8b24b94a2026-10-14
  • R21-11rel:R21-11#6fc896c62026-10-14
  • R22-11rel:R22-11#e1f8fedf2026-10-14
  • R23-11rel:R23-11#f147daab2026-10-14
  • R24-11rel:R24-11#911d64682026-10-14
  • R25-11rel:R25-11#bdb871682026-10-14 active
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

函数 operator= [SWS_DM_01663] Upstream: RS_AP_00147

<DataIdentifierInterface3> & operator= (const <DataIdentifierInterface3> &other)=delete;

Copy assignment constructor deletion

Header-Datei#include "<DataIdentifierDirectoryPath>/<DataIdentifierShortname>.h"
Scopeclass <DataIdentifier-Namespace>::<DataIdentifierInterface>

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

Record
AUTOSAR/AP/record/SWS_DM_01663
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01663@rel:R25-11#e0b5ac17
Content hash
e0b5ac17
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01663
Status: valid/unmigrated Version: rel:R25-11#84430c7f 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_01663@rel:R25-11#84430c7f
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#e8fc0e1d2026-09-30
  • R23-11rel:R23-11#32ce8d7c2026-10-14
  • R24-11rel:R24-11#d7cea82e2026-10-14
  • R25-11rel:R25-11#84430c7f2026-10-14 active
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

函数 operator= [SWS_DM_01664] Upstream: RS_AP_00147

<DataIdentifierInterface5> & operator= ( <DataIdentifierInterface5> &&other)=delete;

Move assignment constructor

Header-Datei#include "<DataIdentifierDirectoryPath>/<DataIdentifierShortname>.h"
Scopeclass <DataIdentifier-Namespace>::<DataIdentifierInterface>

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

Record
AUTOSAR/AP/record/SWS_DM_01664
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01664@rel:R25-11#7394dd87
Content hash
7394dd87
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01664
Status: valid/unmigrated Version: rel:R25-11#22a1078d 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_01664@rel:R25-11#22a1078d
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#38d959842026-09-30
  • R23-11rel:R23-11#e483c5232026-10-14
  • R24-11rel:R24-11#8aad364b2026-10-14
  • R25-11rel:R25-11#22a1078d2026-10-14 active
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

函数 ~<DataIdentifierInterface> [SWS_DM_00586] Upstream: RS_Diag_04169, RS_AP_00134

virtual ~<DataIdentifierInterface6> ();

Destruction of a DataIdentifier

Header-Datei#include "<DataIdentifierDirectoryPath>/<DataIdentifierShortname>.h"
Scopeclass <DataIdentifier-Namespace>::<DataIdentifierInterface>
Exception-Sicherheitnot exception safe
Thread-Sicherheitnot thread-safe

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

Record
AUTOSAR/AP/record/SWS_DM_00586
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00586@rel:R25-11#b61f6117
Content hash
b61f6117
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00586
Status: valid/unmigrated Version: rel:R25-11#30bedd44 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_00586@rel:R25-11#30bedd44
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#5bb9ad312026-09-30
  • R19-11rel:R19-11#e08946d32026-10-14
  • R20-11rel:R20-11#74e8f77a2026-10-14
  • R21-11rel:R21-11#42adefc82026-10-14
  • R22-11rel:R22-11#6fb7460b2026-10-14
  • R23-11rel:R23-11#b224e2552026-10-14
  • R24-11rel:R24-11#0c307cd32026-10-14
  • R25-11rel:R25-11#30bedd442026-10-14 active
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

常量 / 变量文档

变量 <DataIdentifierOutArg> [SWS_DM_80013] Upstream: RS_Diag_04224, RS_Diag_04169

<DataIdentifierOutArgType> <DataIdentifierOutArg>;

Member declaration representing an out argument in an Output.

Header-Datei#include "<DataIdentifierDirectoryPath>/<DataIdentifierShortname>.h"
Scopeclass <DataIdentifier-Namespace>::<DataIdentifierInterface>
Symbol<DataIdentifierOutArg>
Typ<DataIdentifierOutArgType>

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

Record
AUTOSAR/AP/record/SWS_DM_80013
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_80013@rel:R25-11#83b6d776
Content hash
83b6d776
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_80013
Status: valid/unmigrated Version: rel:R25-11#a48f634f Versionshistorie & Revisions (1 transition, 3 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_80013@rel:R25-11#a48f634f
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#563214cb2026-09-30
  • R24-11rel:R24-11#866631f72026-10-14
  • R25-11rel:R25-11#a48f634f2026-10-14 active
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