类 ara::rds::IEEE1722DatagramAVTPDUCommonHeaderFields

类 ara::rds::IEEE1722DatagramAVTPDUCommonHeaderFields 在 Raw Data Stream 模块中用作基础数据结构，用于表示 IEEE 1722 AVTPDU ([SWS_RDS_90230]) 的标准化报头字段。它封装了协议版本、子类型和格式特定控制位的受保护属性，派生的数据报类在发送时填充并在接收时评估这些属性。声明为虚函数且带有 noexcept 的析构函数 ([SWS_RDS_90233]) 可确保实例异常安全的多态清理。

更多 ›

上下文

在 AUTOSAR Adaptive Platform 中，Raw Data Stream (RDS) 模块提供了用于非结构化数据流和标准化流协议高效交换的机制。类 ara::rds::IEEE1722DatagramAVTPDUCommonHeaderFields 在该模块内用作符合 IEEE 1722 的音视频传输协议数据单元 (AVTPDU) 通用报头字段（Common Header Fields）的基本表示，如 SWS RawDataStream §1 “IEEE 1722 Datagram” 中所指定。

该结构封装了在 IEEE 1722 标准中为 AVTPDU 数据报定义的核心协议字段。其中包括类型为 std::uint8_t ([SWS_RDS_90232]) 的属性 version，用于映射 AVTP 标准的协议版本。此外，类型为 std::uint16_t ([SWS_RDS_90230]) 的数据字段 avtpStreamDataSubtype 接收 AVTP 流式有效负载的子类型，以标识所传输数据流的特定格式。作为补充，元素 headerSpecific 作为 std::uint8_t ([SWS_RDS_90231]) 存储 AVTPDU 报头的协议特定和格式特定控制位与标志。

该类的所有有效负载数据字段均在访问修饰符 protected 下声明。由此得出的解释是：ara::rds::IEEE1722DatagramAVTPDUCommonHeaderFields 主要可能被设计为 RDS 模块内专用 IEEE 1722 数据报类的基础基类，而不是由用户直接作为独立值对象实例化。 问题 Q-674fc96343869829 (未决)

生命周期

ara::rds::IEEE1722DatagramAVTPDUCommonHeaderFields 的生命周期与其作为基本报头结构的角色相对应。其实例化是与继承自该基类的具体特化结合进行的。受保护属性 version ([SWS_RDS_90232])、avtpStreamDataSubtype ([SWS_RDS_90230]) 和 headerSpecific ([SWS_RDS_90231]) 的赋值与初始化通常在派生类的构造函数中进行。

对于实例的销毁，规范显式提供了一个虚析构函数：~IEEE1722DatagramAVTPDUCommonHeaderFields() noexcept ([SWS_RDS_90233])。该虚析构函数的存在确保了派生数据报对象可以通过指向基类的指针或引用安全地进行多态销毁，而不会导致未定义行为或资源泄漏。通过说明符 noexcept，在契约上保证了在析构过程中不会引发异常。

关于所有权和内存管理，该类遵循 RDS 模块中数据传输对象的通用约定：实例通常保留在处理函数的栈上，或者由上层数据缓冲区和流处理程序管理。关于并发性，该数据结构不提供内部同步机制。解释：因此，多个线程对同一实例的同时访问可能需要调用应用程序或周围的运行时系统进行外部同步。 问题 (未决)

使用路径

典型的使用路径分为在流连接上下文中创建、填充和评估数据报。由于字段是受保护的，开发人员通过专用的子类访问这些基本字段。

在发送 IEEE 1722 数据流时，应用程序或 RDS 模块的内部流水线会实例化一个派生数据报类。随后填充通用 AVTPDU 报头字段：字段 version ([SWS_RDS_90232]) 设置为当前支持的协议版本状态。字段 avtpStreamDataSubtype ([SWS_RDS_90230]) 设置为特定有效负载类型的标识值，以使接收方能够对数据流进行解码。最后，派生实现根据 IEEE 1722 规范配置包含所需控制位的字段 headerSpecific ([SWS_RDS_90231])。

当通过 Raw Data Stream 接收网络数据包时，执行相反的流程：入站原始数据被反序列化并传输到派生数据报类的相应属性中。随后，上层组件可以通过多态接口或子类的类型化访问方法检查报头信息。在成功处理 AVTPDU 有效负载并将其转发到目标接收端后，数据报被释放，其中虚析构函数 ([SWS_RDS_90233]) 确保所有资源的干净释放。解释：通过网络进行的序列化传输可能通过 RDS 栈的下游序列化程序完成，这些序列化程序将报头按照符合 IEEE 1722 的格式排列在字节流中。 问题 Q-7f31ac02b5e4facf (未决)

错误场景

使用 ara::rds::IEEE1722DatagramAVTPDUCommonHeaderFields 时的错误场景主要源于报头字段中的错误值或不当的生命周期管理。

在数据元素层面，无效值可能导致协议违背。例如，若为 version ([SWS_RDS_90232]) 传递了对端不支持的版本值，可能导致通信对端丢弃整个 AVTPDU。同样，错误设置的字段 avtpStreamDataSubtype ([SWS_RDS_90230]) 会导致接收方无法将数据流正确分配给匹配的解码器。而 headerSpecific ([SWS_RDS_90231]) 的不一致配置又可能引起关于同步标志或数据长度的错误解释。

在 C++ 层面，虚析构函数 ~IEEE1722DatagramAVTPDUCommonHeaderFields() noexcept ([SWS_RDS_90233]) 排除了销毁过程中的异常。如果派生类在释放资源期间执行自己的错误处理逻辑，必须确保该处也不会抛出异常，以防止通过 std::terminate 导致程序立即终止。