结构体 ara::diag::CommunicationControl::ComCtrlRequestParamsType

该数据结构根据 [SWS_DM_00805] 汇集了用于自适应通信控制的 UDS 服务请求 0x28 的所有输入参数。当接收到此类诊断报文时，平台会反序列化控制类型、通信类型以及节点标识，并将填充后的结构传递给相应的服务处理程序。应用软件对包含的值进行评估，以便有针对性地影响已定义网络段的发送和接收行为（AUTOSAR_AP_SWS_Diagnostics §8.7.2 “Struct: ComCtrlRequestParamsType”）。作为一个无状态数据容器，该结构本身没有并发同步机制，因此访问应当保留在处理程序的执行上下文内。

更多 ›

上下文

结构 ara::diag::CommunicationControl::ComCtrlRequestParamsType 是 AUTOSAR Adaptive 功能诊断接口内的核心数据传输类型 [SWS_DM_00805]。它在头文件 ara/diag/communication_control.h 中声明，并用作封装 UDS 服务 0x28（CommunicationControl）诊断请求的所有输入参数的标准化参数容器（AUTOSAR_AP_SWS_Diagnostics §8.7.2 “Struct: ComCtrlRequestParamsType”）。

在整个系统中，该结构充当 AUTOSAR 诊断管理（Diagnostic Management）与负责车辆特定通信控制的自适应应用软件之间的中介。来自外部测试仪的传入诊断命令在平台层被反序列化，并通过该结构传递给应用程序。该结构包含三个公共成员变量（AUTOSAR_AP_SWS_Diagnostics §8.7.2.1 “Public Member Variables”）：

• controlType（[SWS_DM_01562]、AUTOSAR_AP_SWS_Diagnostics §8.7.2.1.2 “controlType”）：定义为 std::uint8_t，该字段传输从 UDS 请求中提取的子功能，用于指定要执行的控制过程。
• communicationType（[SWS_DM_01563]、AUTOSAR_AP_SWS_Diagnostics §8.7.2.1.1 “communicationType”）：同样为类型 std::uint8_t，该字段表示 UDS 请求中指定的通信类型（例如正常通信或网络管理通信）。
• nodeIdentificationNumber（[SWS_DM_01564]、AUTOSAR_AP_SWS_Diagnostics §8.7.2.1.3 “nodeIdentificationNumber”）：定义为 std::uint16_t，该变量标识控制指令所指向的具体目标节点或子网络。

生命周期

作为基本 C++ 结构（struct）[SWS_DM_00805]，ComCtrlRequestParamsType 具有简单值类型（Plain Old Data / POD）的特征。它没有内部状态机、没有虚函数指针，也没有动态分配的内存区域（AUTOSAR_AP_SWS_Diagnostics §8.7.2.1 “Public Member Variables”）。

实例的创建通常由 Diagnostic Management 框架临时执行：一旦接收到 UDS 0x28 报文并在形式上通过验证，协议栈便会实例化该结构并使用解码后的有效负载数据初始化成员变量（解释：在请求接收过程中，对象创建完全由中间件负责）。 问题 Q-1abe8049ce5759f2 (未决)所有权关系严格限制在方法调用的上下文中。平台通常按值或通过常量引用将实例传递给应用程序的服务处理程序；接收的应用程序不会对实例承担持久所有权。

相应地，不存在生命周期阶段或复杂的状态转换。随着离开相应回调调用的作用域，实例会自动销毁。在并发性方面，ComCtrlRequestParamsType 未实现自己的同步机制。由于平台完成初始化后，成员通常仅由应用软件进行只读评估，因此只要将实例按线程局部方式传递给处理上下文，访问就应当是线程安全的（解释：评估过程无需外部锁）。 问题 Q-d654753d06273bca (未决)

使用路径

诊断处理范围内的典型使用路径遵循从网络报文到应用程序响应的固定步骤顺序（AUTOSAR_AP_SWS_Diagnostics §8.7.2 “Struct: ComCtrlRequestParamsType”）：

1. 接收诊断报文：外部诊断测试仪向 ECU 发送 UDS 0x28 请求。Adaptive Diagnostic Management 在传输层接收该数据包。
2. 反序列化与实例化：诊断栈解析有效负载，创建 ComCtrlRequestParamsType 的实例 [SWS_DM_00805]，并为字段 controlType [SWS_DM_01562]、communicationType [SWS_DM_01563] 以及 nodeIdentificationNumber [SWS_DM_01564] 分配传输的值。
3. 传递给服务处理程序：中间件将该实例转发给自适应应用程序中 CommunicationControl 接口所实现的回调方法。
4. 参数评估与执行：自适应应用程序读取该结构。根据 nodeIdentificationNumber [SWS_DM_01564] 确定寻址的是自身节点还是子网络。随后通过 controlType [SWS_DM_01562] 和 communicationType [SWS_DM_01563] 激活或停用相应的发送和接收模式。
5. 反馈：执行成功后，应用程序向 Diagnostic Management 确认该过程，后者将符合标准的正向 UDS 响应发送给诊断测试仪。

时序图：从 UDS 0x28 报文到应用程序中参数评估的请求处理典型流程。来源：[SWS_DM_00805]、AUTOSAR_AP_SWS_Diagnostics §8.7.2 “Struct: ComCtrlRequestParamsType”