类 <RoutineInterface-Namespace>::<RoutineInterface>

构造函数 [SWS_DM_00589] 用于通过实例标识符实例化例程接口（DiagnosticRoutine）。声明被指定为 noexcept，并且被视为异常安全（exception safe）以及线程安全（thread-safe）SWS Diagnostics §8.30.2.2.1.8 “{<routine-interface-name-1>}”。

参数与调用

• instanceSpec（ara::core::InstanceSpecifier）：绑定到匹配模型端口的特定服务实例的标识符。
• concurrencyType（ara::diag::ConcurrencyType）：确定接口是并发或线程安全地执行（kConcurrent）还是非线程安全的（kNotConcurrent）。

运行时与模型检查

在构造期间，框架会检查模型和进程配置。在发生错误分配或多次使用时，会触发特定的违规（Violations）[SWS_DM_00589]：

• InstanceSpecifierMappingIntegrityViolation：InstanceSpecifier 无法在可执行文件的上下文中解析，或者未指向 PortPrototype。
• PortInterfaceMappingViolation：由 DiagnosticRoutineInterface 类型化的 PortPrototype 未被 DiagnosticServiceGenericMapping 引用。
• ProcessMappingViolation：对于现有的实例引用，运行时不存在匹配的建模进程。
• InstanceSpecifierAlreadyInUseViolation：指定的 InstanceSpecifier 在当前进程内已被现有实例使用。

用法与语义

方法 Offer 启用 Diagnostic Management (DM)，以便将传入的诊断请求转发给关联的例程处理程序 [SWS_DM_00594]。该调用通过例程的类型化接口同步且无参数地进行，并且不抛出异常（noexcept）[SWS_DM_00594]。返回值类型为 ara::core::Result<void>，由此指示成功完成，或在发生错误时返回错误代码 [SWS_DM_00594]。

错误处理

如果对已主动提供给 DM 的例程实例调用 Offer，则注册失败。在这种情况下，该方法返回具有回滚语义的错误代码 DiagOfferErrc::kAlreadyOffered [SWS_DM_00594]（在诊断错误域的常规上下文中定义为值 101 [SWS_DM_00514]）。

并发性与限制

虽然该函数被指定为异常安全（exception safe），但明确声明为非线程安全（not thread-safe）[SWS_DM_00594]。不得在同一实例上未受保护地并发执行多次调用。由于规范未预见并发使用，注册通常应当在处理应用程序的初始化阶段同步进行。 问题 Q-6a0f15497f03ac09 (未决)

诊断模块中的交互

通过 Offer 进行提供的模式在 AUTOSAR 诊断管理中针对不同接口类型进行了统一，例如通用例程 [SWS_DM_00557]、数据元素 [SWS_DM_00597]、DataIdentifier [SWS_DM_00599] 以及通用 UDS 服务 [SWS_DM_00619]。尽管命名借鉴了 ara::com，但这属于诊断特有的功能，不得与常规服务代理混淆 AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 “Monitors”。

使用

接口方法 RequestResult 用于在定型诊断接口 [SWS_DM_00593] 内提供用于查询例程结果的 RoutineControl 功能。在调用以处理 UDS 子功能 requestRoutineResults（服务 0x31，参见 [SWS_DM_00575]）时，将传递关联 ArgumentDataPrototype 的有序输入参数、通过 metaInfo 提供的元信息以及 cancellationHandler AUTOSAR_AP_SWS_Diagnostics §8.30.2.2.1.2 “RequestResult”。

通过对象 cancellationHandler，实现可以通过 IsCanceled 主动检查当前诊断会话是否已中止，或通过 SetNotifier 注册一个在中止时被调用的通知函数 [SWS_DM_00593]。执行以异步方式进行，并返回一个 ara::core::Future，该对象在成功时包含符合 [SWS_DM_00583] 的结果对象 [SWS_DM_00593]。

错误处理

如果在处理过程中发生错误，ara::core::Future 将以相应错误解析。这包括通过 ara::diag::DiagUdsNrcErrc 的否定响应码（符合 ISO 14229-1 的 NRC）或通过 Ap ApplicationError 的应用特定错误 [SWS_DM_00593]。

并发性与限制

该方法声明为 noexcept 且被视为异常安全（exception safe），但明确为非线程安全（not thread-safe）AUTOSAR_AP_SWS_Diagnostics §8.30.2.2.1.2 “RequestResult”。基于此分类，调用组件应负责在同一实例上进行并行调用时提供适当的同步。 问题 Q-aa5788303ddff2bc (未决)

类作用域 <RoutineInterface-Namespace>::<RoutineInterface> 中的纯虚函数 Start 用于为模型特定诊断例程（[SWS_DM_00591]）提供角色为 Start 的 RoutineControl 操作。它通过头文件 <RoutineInterfaceDirectoryPath>/<RoutineInterfaceShortname>.h 声明（[SWS_DM_00591]）。该调用传递各例程的有序输入参数、通过 metaInfo 传递的诊断上下文信息，以及用于控制会话取消的对象 cancellationHandler（[SWS_DM_00591]）。

通过参数 cancellationHandler，实现可以使用 cancellationHandler.IsCanceled 检查关联的会话是否已取消，其中在取消的情况下返回 TRUE，否则返回 FALSE（[SWS_DM_00591]）。此外，可以使用 cancellationHandler.SetNotifier 注册一个在取消情况下触发的通知函数（[SWS_DM_00591]）。异步返回通过 ara::core::Future 进行，成功时该对象提供符合 [SWS_DM_00581] 的已生成结果对象 StartOutput（[SWS_DM_00591]）。

在发生错误时，必须为 ara::core::Future 赋予来自 ara::diag::DiagUdsNrcErrc 的符合 ISO 14229-1 的适当否定响应码（NRC）或应用特定的 ApplicationError（[SWS_DM_00591]）。该方法被指定为 noexcept 和 exception safe，但被视为 not thread-safe（[SWS_DM_00591]）。Interpretation：从归类为 not thread-safe 可以推断，对同一实例的并发调用可能必须进行外部同步。 问题 Q-124d8076818ac2e1 (未决)虽然该接口服务于模型特定生成的例程，但 GenericRoutine::Start 为以通用方式处理的诊断例程提供了功能对等物（[SWS_DM_00554]）。

方法 Stop 用于在类型化例程接口（[SWS_DM_00592]）内提供用于停止诊断例程的 RoutineControl 功能。与通用对应项 [SWS_DM_00555] 类似，调用通常可能由 Diagnostic Management 守护进程在收到相应的 UDS 诊断请求（子功能 0x02）时触发。 问题 Q-cd626f527c6dfe92 (未决)

调用以异步方式进行并返回一个 ara::core::Future（[SWS_DM_00592]）：

• 参数：除了模型特定的输入参数 {<routine-interface-stop-in-arg-symbol-0toN>} 之外，还会传递请求的元信息（metaInfo）以及一个 cancellationHandler（[SWS_DM_00592]）。通过 cancellationHandler，实现可以通过 IsCanceled 主动查询取消，或者注册 SetNotifier 通知，以便在诊断会话被取消时收到通知。
• 返回值：成功停止时，Future 提供一个类型化的 StopOutput 对象（[SWS_DM_00582]）。

错误处理：如果停止失败，返回的 Future 将包含通过 ara::diag::DiagUdsNrcErrc 获得的符合 ISO 14229-1 的适用否定响应码（NRC）或模型特定的 Ap ApplicationError（[SWS_DM_00592]）。

并发性与限制：该函数被指定为 exception safe，但被明确指定为 not thread-safe（[SWS_DM_00592]）。同一接口实例上的多次或并发调用必须由调用方进行协调，并且例程必须释放任何资源或对处理程序的取消请求作出响应。

<RoutineInterface> 作用域中的方法 StopOffer 用于禁用从 Diagnostic Management (DM) 到例程实现的诊断请求消息转发 [SWS_DM_00595]。该函数没有传入参数，也不返回值 [SWS_DM_00595]。

• 使用与调用上下文：该调用同步进行，以注销在 DM 处的例程接口注册。声明位于头文件 <RoutineInterfaceDirectoryPath>/<RoutineInterfaceShortname>.h 中 [SWS_DM_00595]。尽管其命名借鉴了 ara::com 的服务方法，但它是 DM 的诊断专用 API，不得与通信管理相混淆（AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 “Monitors”）。
• 错误处理：该操作被声明为 noexcept，并被归类为异常安全（exception safe）[SWS_DM_00595]。未针对此方法定义特定的错误码或错误消息。
• 并发性与限制：该函数被指定为非线程安全（not thread-safe）[SWS_DM_00595]；因此，对同一实例的调用需要外部同步。Interpretation：调用方可能必须在调用之前有序终止正在运行的例程执行，因为该标准仅描述了转发机制的禁用。 问题 Q-b0f524c0f2d7af52 (未决)
• 交互：提供和注销模式符合 Diagnostic Management 中的标准化方法，正如其类似地为通用例程 [SWS_DM_00558]、通用 UDS 服务 [SWS_DM_00620] 和数据标识符 [SWS_DM_00600] 所规定的那样。