DEENESPTFRRUARHIKOZHNL

类 ara::diag::GenericUDSService

[SWS_DM_00602] Upstream: RS_Diag_04169

class GenericUDSService {...};

Generic UDS interface.

Header-Datei#include "ara/diag/generic_uds_service.h"
Forwarding-Header#include "ara/diag/diag_fwd.h"
Scopenamespace ara::diag

用户指南人工智能生成

用作通用 UDS 接口,用于在诊断管理器中异步处理传入的诊断请求。
AI 生成 未审核 模型: gemini-3.8-flash-medium · 推理强度: medium · 温度: 不可控 · 提示词: d0d38c589b70 来源
译自德文指南gemini-3.8-flash-low · 2026-10-13 · 德文原文

用作通用 UDS 接口,用于在诊断管理器中异步处理传入的诊断请求。

作为通用 UDS 服务处理器,类 ara::diag::GenericUDSService 允许通过 AUTOSAR 诊断管理器接收和处理任意 UDS 诊断请求 [SWS_DM_00616]。在绑定到 PortPrototype 之后,该服务通过 Offer() 激活,在方法 HandleMessage() 中异步处理请求,并通过 StopOffer() 再次注销 [SWS_DM_00618]、[SWS_DM_00619]、[SWS_DM_00620]。该实例既不可复制也不可移动,并通过来自 DiagUdsNrcErrc 的 NRC 指示错误 [SWS_DM_01657]、[SWS_DM_00618]。

上下文

类 ara::diag::GenericUDSService 提供了用于符合 UDS(Unified Diagnostic Services)的诊断通信的通用服务接口。它作为基类,供希望实现并处理自定义或未被专用接口覆盖的 UDS 服务的应用程序使用。交互主要在进行诊断的应用程序组件、AUTOSAR 诊断管理器(DM)以及底层建模上下文之间进行。在实例化时,通过指向 DiagnosticGenericUdsInterface 的相应端口原型的 ara::core::InstanceSpecifier 实现与诊断管理器及平台模型的连接 [SWS_DM_00616]。一旦通过该接口激活注册,诊断管理器就会将传入的 UDS 请求转发给实现的实例 [SWS_DM_00619]。

GenericUDSContext DM Diagnostic-Manager (DM) Service ara::diag::GenericUDSService DM->Service Offer() / StopOffer() DM->Service HandleMessage(sid, data) App Applikations-Handler Service->App Virtuelle Abarbeitung App->DM Future<OperationOutput> Model AUTOSAR Modell / InstanceSpecifier Model->Service Konfiguration / PortPrototype

上下文图:ara::diag::GenericUDSService 与 DM 及应用程序的组件和交互上下文。来源:[SWS_DM_00616]、[SWS_DM_00618]、[SWS_DM_00619]

生命周期

ara::diag::GenericUDSService 的实例绑定到固定的端口原型,并被设计为单例(独占实例):复制构造函数 [SWS_DM_01657]、移动构造函数 [SWS_DM_01658] 以及赋值运算符 [SWS_DM_01655]、[SWS_DM_01656] 均已被删除(delete)。通过构造函数显式创建,并指定 InstanceSpecifier 以及并发配置 ConcurrencyType(kConcurrent 或 kNotConcurrent)[SWS_DM_00616]。服务就绪的生命周期分为两个主要阶段:

  • 未提供(Stopped / Initial):在构造之后或调用 StopOffer() 之后,DM 不会将请求转发给该实例 [SWS_DM_00620]。
  • 已提供(Offered):成功调用 Offer() 后,处理程序处于活动状态并处理传入的诊断消息 [SWS_DM_00619]。

销毁通过虚析构函数 ~GenericUDSService() 执行 [SWS_DM_00584]。在线程安全性方面,构造函数被指定为线程安全的,而 Offer()、StopOffer() 和析构函数则不是线程安全的,需要进行外部同步 [SWS_DM_00616]、[SWS_DM_00619]、[SWS_DM_00620]、[SWS_DM_00584]。

GenericUDSLifecycle Uninitialized 不存在 Stopped 就绪 / 未提供 Uninitialized->Stopped Konstruktor(specifier, concurrencyType) Stopped->Uninitialized ~GenericUDSService() Offered Angeboten (Aktiv) Stopped->Offered Offer() Offered->Stopped StopOffer() Offered->Offered HandleMessage()

状态图:生命周期与服务提供状态。来源:[SWS_DM_00616]、[SWS_DM_00619]、[SWS_DM_00620]、[SWS_DM_00584]

使用路径

常规流程包括派生服务类的实例化、处理程序的启用、异步任务处理以及后续的停用:

  1. 实例化:应用程序使用匹配的 ara::core::InstanceSpecifier 以及所需的 ConcurrencyType 实例化专门的服务类 [SWS_DM_00616]。
  2. 提供服务:调用 Offer() 向诊断管理器发出准备接收消息的信号 [SWS_DM_00619]。
  3. 消息处理:传入的 UDS 请求会促使 DM 调用纯虚方法 HandleMessage()。传递的参数包括服务标识符(sid)、有效载荷数据(requestData)、元数据(metaInfo)以及一个 cancellationHandler [SWS_DM_00618]。该方法返回一个 ara::core::Future<OperationOutput>,结果或错误将通过其异步提供 [SWS_DM_00618]。处理程序可以通过 cancellationHandler.IsCanceled() 检查操作是否已取消,或者通过 cancellationHandler.SetNotifier() 注册通知 [SWS_DM_00618]。
  4. 停止服务:在实例被销毁之前,通过 StopOffer() 终止请求的转发 [SWS_DM_00620]、[SWS_DM_00584]。
通过 GenericUDSService 处理 UDS 请求ApplikationGenericUDSServiceDiagnostic-ManagerErzeugung(specifier, concurrencyType)Offer()Handler registrierenResult<void> (Erfolg)Use Case: Diagnoseanfrage bearbeitenHandleMessage(sid, requestData, metaInfo, cancelHandler)altVerarbeitung erfolgreichFuture::set_value(OperationOutput)Fehlerfall / AblehnungFuture::set_error(DiagUdsNrcErrc)Use Case: Dienst deregistrierenStopOffer()Handler deregistrieren

时序图:注册、消息处理和注销时的典型调用流程。来源:[SWS_DM_00616]、[SWS_DM_00618]、[SWS_DM_00619]、[SWS_DM_00620]

错误场景

错误情况可能在不同阶段发生,需要进行差异化处理:

  • 实例化违例:如果在模型中分配 InstanceSpecifier 失败,框架将报告已定义的违规:InstanceSpecifierMappingIntegrityViolation(说明符无法在模型中解析或未指向 PortPrototype)、PortInterfaceMappingViolation(端口未通过 DiagnosticServiceGenericMapping 引用)、ProcessMappingViolation(未建模匹配的进程)或 InstanceSpecifierAlreadyInUseViolation(说明符已在进程中使用)[SWS_DM_00616]。
  • 重复提供调用:如果在服务已处于活动提供状态时调用 Offer(),则调用失败并返回错误代码 DiagOfferErrc::kAlreadyOffered(回滚语义)[SWS_DM_00619]。
  • 诊断相关的执行错误:如果 HandleMessage() 中的 UDS 消息在业务上无法得到肯定应答,则必须通过 DiagUdsNrcErrc 在 Future 中填入符合 ISO 14229-1 的相应否定响应码(NRC)[SWS_DM_00618]。此外,如果底层诊断会话提前终止,实现必须对 cancellationHandler 的取消信号做出响应 [SWS_DM_00618]。

本类指南基于 AUTOSAR 标准自动生成。

成员图

构造函数和析构函数

2

运算符

1

嵌套类型

1

类图

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

G nara__diag__GenericUDSService134 GenericUDSService + GenericUDSService() + operator=() + ~GenericUDSService() + HandleMessage() + Offer() + StopOffer()

详细视图

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

构造函数和析构函数

Constructor of GenericUDSService.

重载 GenericUDSService 3
explicit GenericUDSService (const ara::core::InstanceSpecifier &specifier, ConcurrencyType concurrencyType) noexcept; SWS_DM_00616
GenericUDSService (GenericUDSService &)=delete; SWS_DM_01657
GenericUDSService (GenericUDSService &&) noexcept=delete; SWS_DM_01658

Destructor of GenericUDSService.

virtual ~GenericUDSService () noexcept;

方法

Called for any request message.

virtual ara::core::Future< OperationOutput > HandleMessage (std::uint8_t sid, ara::core::Span< const std::uint8_t > requestData, const MetaInfo &metaInfo, CancellationHandler cancellationHandler) noexcept=0;
Offer 函数

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

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

This StopOffer will disable the forwarding of request messages from DM.

void StopOffer () noexcept;

运算符

operator= 函数 2

GenericUDSService shall be a single not assignable instance.

重载 = 2

嵌套类型

方法文档

函数 GenericUDSService [SWS_DM_00616] Upstream: RS_AP_00137, RS_Diag_04169, RS_AP_00170, RS_AP_00171, RS_AP_00172, RS_AP_00173

explicit GenericUDSService (const ara::core::InstanceSpecifier &specifier, ConcurrencyType concurrencyType) noexcept;

Constructor of GenericUDSService.

Header-Datei#include "ara/diag/generic_uds_service.h"
Scopeclass ara::diag::GenericUDSService
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 DiagnosticGenericUdsInterface needs to be referenced by a DiagnosticServiceGenericMapping. 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
specifierInstanceSpecifier to a PortPrototype of a DiagnosticGenericUdsInterface.
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_00616
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00616@rel:R25-11#e039192f
Content hash
e039192f
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00616
Status: valid/unmigrated Version: rel:R25-11#3d790c95 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_00616@rel:R25-11#3d790c95
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#87df61712026-09-30
  • R19-11rel:R19-11#84d8fb9f2026-10-14
  • R20-11rel:R20-11#50d1ef612026-10-14
  • R21-11rel:R21-11#bc4b87432026-10-14
  • R22-11rel:R22-11#927edc252026-10-14
  • R23-11rel:R23-11#f591fa1b2026-10-14
  • R24-11rel:R24-11#bb9f2bcf2026-10-14
  • R25-11rel:R25-11#3d790c952026-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

函数 GenericUDSService [SWS_DM_01657] Upstream: RS_AP_00147

GenericUDSService (GenericUDSService &)=delete;

GenericUDSService shall be a single not copy-able instance.

Header-Datei#include "ara/diag/generic_uds_service.h"
Scopeclass ara::diag::GenericUDSService

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

Record
AUTOSAR/AP/record/SWS_DM_01657
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01657@rel:R25-11#605a92a3
Content hash
605a92a3
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01657
Status: valid/unmigrated Version: rel:R25-11#76928831 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_01657@rel:R25-11#76928831
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#be554e2d2026-09-30
  • R23-11rel:R23-11#a940ac8f2026-10-14
  • R24-11rel:R24-11#769288312026-10-14
  • R25-11rel:R25-11#769288312026-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

函数 GenericUDSService [SWS_DM_01658] Upstream: RS_AP_00147

GenericUDSService (GenericUDSService &&) noexcept=delete;

Move constructor of GenericUDSService.

Header-Datei#include "ara/diag/generic_uds_service.h"
Scopeclass ara::diag::GenericUDSService

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

Record
AUTOSAR/AP/record/SWS_DM_01658
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01658@rel:R25-11#3d1980e4
Content hash
3d1980e4
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01658
Status: valid/unmigrated Version: rel:R25-11#595ee4df 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_01658@rel:R25-11#595ee4df
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#fd8860f32026-09-30
  • R23-11rel:R23-11#a5685d662026-10-14
  • R24-11rel:R24-11#595ee4df2026-10-14
  • R25-11rel:R25-11#595ee4df2026-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

函数 HandleMessage [SWS_DM_00618] Upstream: RS_AP_00119, RS_AP_00138, RS_Diag_04169, RS_Diag_04170, RS_ Diag_04172, RS_Diag_04173

virtual ara::core::Future< OperationOutput > HandleMessage (std::uint8_t sid, ara::core::Span< const std::uint8_t > requestData, const MetaInfo &metaInfo, CancellationHandler cancellationHandler) noexcept=0;

Called for any request message.

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

来自 ara::diag::GenericUDSService 的方法 HandleMessage 用于对传入的 UDS 诊断请求进行应用程序特定的处理 [SWS_DM_00618]。

使用

Diagnostic Management (DM) 为每个接收到的诊断请求消息调用该方法 [SWS_DM_00618]。基于这些参数,传递服务标识符(sid)、有效载荷数据(requestData 作为 ara::core::Span<const std::uint8_t>)、连接信息(metaInfo)以及 cancellationHandler。处理通过返回 ara::core::Future<OperationOutput> 异步进行 [SWS_DM_00618]。requestData 中的有效载荷数据保持有效,直到关联的 Promise 被满足或操作被取消。通过 cancellationHandler.IsCanceled(),应用程序可以检查取消状态,或通过 cancellationHandler.SetNotifier() 注册会话中止的通知 [SWS_DM_00618]。

错误处理

如果请求无法成功处理,应用程序将通过返回的 Future 并通过 DiagUdsNrcErrc 使用匹配的否定响应码(符合 ISO 14229-1 的 NRC)来指示错误 [SWS_DM_00618]。

并发性与边界条件

  • metaInfo 的生命周期:metaInfo 对象的有效性严格限制在方法调用的活动执行期内 [SWS_DM_01345]。在从 HandleMessage 返回后进行存储或使用会导致未定义行为。
  • 可重入性与并发性:调用是否必须以线程安全的方式进行,由在构造函数中确定的 ara::diag::ConcurrencyType 决定 SWS Diagnostics §7.3.1.2 “Concurrency of ara::diag interfaces”。在 kConcurrent 的情况下,DM 允许并行调用后续请求;而在 kNotConcurrent 的情况下,DM 会等待直到当前请求的结果被提供。

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

实现者指南即将推出(复杂度 I2)

Header-Datei#include "ara/diag/generic_uds_service.h"
Scopeclass ara::diag::GenericUDSService
Exception-Sicherheitexception safe
Thread-Sicherheitconditional whether the function has to be implemented thread safe or non-thread safe is determined by the ConcurrencyType given in the constructor

Parameter (in)

ParameterBeschreibung
sidDiagnostic Request Service Identifier.
requestDataDiagnostic request data (starting after SID). Lifetime: Valid until Promise is fulfilled or the processing is cancelled by the cancellationHandler.
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<OperationOutput >A Result with either a OperationOutput or an error

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_00618
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00618@rel:R25-11#95177e4d
Content hash
95177e4d
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00618
Status: valid/unmigrated Version: rel:R25-11#256cc37a 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_00618@rel:R25-11#256cc37a
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#99edf6352026-09-30
  • R19-11rel:R19-11#07f4afe82026-10-14
  • R20-11rel:R20-11#97dcd1762026-10-14
  • R21-11rel:R21-11#bf4e483a2026-10-14
  • R22-11rel:R22-11#f4f521dc2026-10-14
  • R23-11rel:R23-11#96bc13662026-10-14
  • R24-11rel:R24-11#8392efc52026-10-14
  • R25-11rel:R25-11#256cc37a2026-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_00619] Upstream: RS_AP_00139, RS_AP_00119, RS_Diag_04169

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 · 温度: 不可控 · 提示词: 19027d24302f 来源 未决问题(1)
译自德文指南gemini-3.8-flash-low · 2026-10-13 · 德文原文

使用

类 ara::diag::GenericUDSService 的方法 Offer 启用诊断请求的转发:它使 Diagnostic Manager (DM) 能够将传入的 UDS 请求消息转发给此处理程序 [SWS_DM_00619]。该同步调用没有参数,不阻塞,并返回 ara::core::Result<void> 作为返回值 [SWS_DM_00619]。解释:执行通常可能在 Adaptive Application 的初始化和启动阶段进行,此时网络上尚无需处理诊断消息。 问题 Q-c1e385a434fe1e4e (未决)

错误处理与并发

该函数声明为 noexcept 并保证异常安全性 [SWS_DM_00619]。如果先前已提供该服务,则注册失败并返回具有回滚语义的错误代码 DiagOfferErrc::kAlreadyOffered [SWS_DM_00619]。关于线程安全性,该接口被指定为 not thread-safe [SWS_DM_00619];在同一实例上的并发调用必须由调用应用程序进行同步。

相互作用

通过 Offer 进行提供符合 AUTOSAR Adaptive 诊断子系统中的标准化注册模式,这与为例程([SWS_DM_00557])或数据标识符([SWS_DM_00638])规定的模式类似。尽管命名借鉴了 ara::com,但它是 Diagnostic Manager 的诊断专用方法 AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 “Monitors”。

本使用说明由 AI 基于 AUTOSAR 规范 R25-11 生成。

实现者指南即将推出(复杂度 I1)

Header-Datei#include "ara/diag/generic_uds_service.h"
Scopeclass ara::diag::GenericUDSService
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe

Rückgabewert

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

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_00619
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00619@rel:R25-11#1e523fee
Content hash
1e523fee
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00619
Status: valid/unmigrated Version: rel:R25-11#ae4f6e9d 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_00619@rel:R25-11#ae4f6e9d
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#05dc2f912026-09-30
  • R19-11rel:R19-11#0e22e9622026-10-14
  • R20-11rel:R20-11#542fec492026-10-14
  • R21-11rel:R21-11#31bb39122026-10-14
  • R22-11rel:R22-11#420b15e72026-10-14
  • R23-11rel:R23-11#7855d6082026-10-14
  • R24-11rel:R24-11#2afc8d572026-10-14
  • R25-11rel:R25-11#ae4f6e9d2026-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_00620] 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 · 温度: 不可控 · 提示词: 5dba8a8b4077 来源 未决问题(1)
译自德文指南gemini-3.8-flash-low · 2026-10-13 · 德文原文

使用

类 ara::diag::GenericUDSService 的方法 StopOffer 停用 Diagnostic Management (DM) 向服务实例 [SWS_DM_00620] 转发传入诊断请求的功能。该函数通过头文件 ara/diag/generic_uds_service.h 提供,不期待任何参数,且返回类型为 void [SWS_DM_00620]。

错误处理

该方法指定为 noexcept 且为异常安全(exception safe)[SWS_DM_00620]。它不抛出异常且不返回错误代码;转发的停止以确定性方式进行。

并发性与限制

根据规范,StopOffer 被归类为非线程安全(not thread-safe)[SWS_DM_00620]。针对同一实例的并发调用必须在应用程序端进行保护。理解:StopOffer 的调用通常应该发生在实例对象销毁之前或暂时不可用时,以防止挂起的转发。 问题 Q-408323dd00c313c0 (未决)

相互作用

StopOffer 的概念遵循 ara::diag 内部一致的架构模式,该模式同样适用于通用例程 [SWS_DM_00558]、通用数据标识符 [SWS_DM_00639]、安全访问 [SWS_DM_00767] 以及监控器 [SWS_DM_01089]。尽管名称参考了 ara::com,但它属于 Diagnostic Management AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 “Monitors” 的独立实现。

本使用说明由 AI 生成,完全基于 AUTOSAR 版本 R25-11 的规范。

实现者指南即将推出(复杂度 I2)

Header-Datei#include "ara/diag/generic_uds_service.h"
Scopeclass ara::diag::GenericUDSService
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_00620
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00620@rel:R25-11#06e2a89e
Content hash
06e2a89e
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00620
Status: valid/unmigrated Version: rel:R25-11#1d426258 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_00620@rel:R25-11#1d426258
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#4e246fdf2026-09-30
  • R19-11rel:R19-11#e52849f92026-10-14
  • R20-11rel:R20-11#66bfb24f2026-10-14
  • R21-11rel:R21-11#7d420efa2026-10-14
  • R22-11rel:R22-11#f6582c092026-10-14
  • R23-11rel:R23-11#f67e3ec02026-10-14
  • R24-11rel:R24-11#b55c0cb92026-10-14
  • R25-11rel:R25-11#1d4262582026-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_01655] Upstream: RS_AP_00147

GenericUDSService & operator= (GenericUDSService &)=delete;

GenericUDSService shall be a single not assignable instance.

Header-Datei#include "ara/diag/generic_uds_service.h"
Scopeclass ara::diag::GenericUDSService

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

Record
AUTOSAR/AP/record/SWS_DM_01655
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01655@rel:R25-11#bb6f61f9
Content hash
bb6f61f9
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01655
Status: valid/unmigrated Version: rel:R25-11#7e13bda6 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_01655@rel:R25-11#7e13bda6
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#a547556d2026-09-30
  • R23-11rel:R23-11#d553807d2026-10-14
  • R24-11rel:R24-11#7e13bda62026-10-14
  • R25-11rel:R25-11#7e13bda62026-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_01656] Upstream: RS_AP_00147

GenericUDSService & operator= (GenericUDSService &&)=delete;

Move assignment operator of GenericUDSService.

Header-Datei#include "ara/diag/generic_uds_service.h"
Scopeclass ara::diag::GenericUDSService

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

Record
AUTOSAR/AP/record/SWS_DM_01656
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01656@rel:R25-11#fd8b5809
Content hash
fd8b5809
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01656
Status: valid/unmigrated Version: rel:R25-11#38601fc9 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_01656@rel:R25-11#38601fc9
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#b4b3af992026-09-30
  • R23-11rel:R23-11#ca5bd3e62026-10-14
  • R24-11rel:R24-11#38601fc92026-10-14
  • R25-11rel:R25-11#38601fc92026-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

函数 ~GenericUDSService [SWS_DM_00584] Upstream: RS_AP_00134, RS_Diag_04169

virtual ~GenericUDSService () noexcept;

Destructor of GenericUDSService.

Header-Datei#include "ara/diag/generic_uds_service.h"
Scopeclass ara::diag::GenericUDSService
Exception-Sicherheitexception 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_00584
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00584@rel:R25-11#7a3ddc80
Content hash
7a3ddc80
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00584
Status: valid/unmigrated Version: rel:R25-11#67b03061 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_00584@rel:R25-11#67b03061
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#1744d32b2026-09-30
  • R19-11rel:R19-11#a888e6d82026-10-14
  • R20-11rel:R20-11#b89a01092026-10-14
  • R21-11rel:R21-11#b89a01092026-10-14
  • R22-11rel:R22-11#b2f7e8712026-10-14
  • R23-11rel:R23-11#0599d30b2026-10-14
  • R24-11rel:R24-11#ac8cbc5b2026-10-14
  • R25-11rel:R25-11#67b030612026-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