DEENESPTFRRUARHIKOZHNL

类 ara::rds::IEEE1722RawDataStreamConsumer

Diese Seite wurde vollständig KI-generiert auf Basis von SWS Raw Data Stream (R25-11) — kein offizieller AUTOSAR-Text und keine automatisch extrahierte API-Seite wie die übrigen Module. Als Interpretation gekennzeichnete Aussagen sind Schlussfolgerungen aus den Quellen.

[SWS_RDS_90311] · Header ara/rds/raw_data_stream_IEEE1722.h

template<typename T> class IEEE1722RawDataStreamConsumer final {...};

Consumer for typed IEEE 1722 stream datagrams.

Header-Datei#include "ara/rds/raw_data_stream_IEEE1722.h"
Scopenamespace ara::rds

用户指南人工智能生成

通过已配置的通信端点接收类型化的 IEEE 1722 流式数据报。
AI 生成 未审核 模型: gemini-3.8-flash-medium · 推理强度: medium · 温度: 不可控 · 提示词: e1b5fefad19b 来源 未决问题(2)
译自德文指南gemini-3.8-flash-low · 2026-10-13 · 德文原文

通过已配置的通信端点接收类型化的 IEEE 1722 流式数据报。

模板类 ara::rds::IEEE1722RawDataStreamConsumer 用于在 AUTOSAR Adaptive Platform 中进行 IEEE 1722 流式数据报的类型化接收。其实例通过静态方法 Create() 带有 InstanceSpecifier 创建 [SWS_RDS_90312],随后通过 Connect() 连接到数据流。通过方法 ReadData(),可以读取最多达到预定最大数量的传入数据报 [SWS_RDS_90321]。复制操作已被禁止,因此连接只能通过移动(Move)操作进行传递,且其执行非线程安全。

上下文

模板类 ara::rds::IEEE1722RawDataStreamConsumer 作为 AUTOSAR Adaptive Platform 的原始数据流模块(rds)内部用于 IEEE 1722 流式数据报的类型化接收器。通过模板参数 T 指定数据报的具体有效负载类型。该类封装了对数据流的访问,并通过 ara::core::InstanceSpecifier 类型的标识符将通信端点绑定到已配置的通信基础设施 [SWS_RDS_90312]。应用程序使用此 Consumer 来直接且资源高效地接收结构化的 AVTP 或 IEEE 1722 有效负载数据流。

生命周期

Consumer 的实例化只能通过静态工厂方法 Create() [SWS_RDS_90312] 在指定目标实例的情况下进行。未为用户提供直接的构造函数调用。该类实现了严格的移动语义(Move-Only 语义):显式禁止复制实例,因为复制构造函数 [SWS_RDS_90316] 和复制赋值运算符 [SWS_RDS_90317] 均已被删除。这确保了底层连接和缓冲区资源始终保持明确的所有权。

为了允许在上下文之间传递所有权,该类提供了移动构造函数 [SWS_RDS_90314] 以及移动赋值运算符 [SWS_RDS_90315]。这两个移动操作均被声明为非线程安全,因此必须同步对同一实例的并发访问。在析构实例时,析构函数 ~IEEE1722RawDataStreamConsumer() 会自动关闭可能仍存在的连接 [SWS_RDS_90318];析构函数同样被指定为非线程安全。

使用路径

使用 IEEE1722RawDataStreamConsumer 的典型流程包括四个连续阶段:

  1. 创建:应用程序通过工厂方法 Create() 使用所需的 ara::core::InstanceSpecifier 创建 Consumer 实例 [SWS_RDS_90312]。
  2. 建立连接:在接收有效数据之前,应用程序通过调用 Connect() [SWS_RDS_90319] 将 Consumer 连接到已配置的数据流。
  3. 数据接收:应用程序重复或周期性调用 ReadData() [SWS_RDS_90321]。在此过程中,参数 maxNumberOfDatagrams 指定在单次调用中要查询的数据报的最大数量。结果以模板类型 T 的 vector 形式返回。
  4. 断开连接:数据传输完成后,应用程序通过 Shutdown() [SWS_RDS_90320] 显式终止连接,或交由析构函数 [SWS_RDS_90318] 进行清理。
Nutzungsablauf IEEE1722RawDataStreamConsumer应用IEEE1722RawDataStreamConsumerCreate(instance)Result<IEEE1722RawDataStreamConsumer<T>>Connect()Result<void>loop只要接收到数据ReadData(maxNumberOfDatagrams)Result<std::vector<T>>Shutdown()Result<void>

时序图:用于 Consumer 的创建、连接、周期性数据报查询和终止的典型使用路径。来源:[SWS_RDS_90312]、[SWS_RDS_90319]、[SWS_RDS_90321]、[SWS_RDS_90320]、[SWS_RDS_90318]。

错误场景

该类的所有常规接口函数——Create() [SWS_RDS_90312]、Connect() [SWS_RDS_90319]、ReadData() [SWS_RDS_90321] 和 Shutdown() [SWS_RDS_90320]——均使用 noexcept 限定,并且不通过 C++ 异常而是通过返回类型 ara::core::Result 指示错误状态。因此,应用程序在访问数据值或执行后续操作之前,必须检查相应的结果是包含值还是包含错误。

可能的错误情况包括:如果 InstanceSpecifier 的配置错误导致实例创建失败,以及在 Connect() 或 ReadData() 期间出现连接中断或网络访问错误。Interpretation:调用 ReadData() 可能要求先前已通过 Connect() 成功建立了连接。 问题 Q-ea5241fe8b3e95a8 (未决)具体的错误原因通常应作为错误代码在返回的 ara::core::Result 中传递。

本指南由 AI 系统基于 AUTOSAR Adaptive Platform Release R25-11 规范生成。

成员图

详细视图

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

构造函数和析构函数

Copy constructor is not allowed.

重载 IEEE1722RawDataStreamConsumer 2
IEEE1722RawDataStreamConsumer(const IEEE1722RawDataStreamConsumer &)=delete; SWS_RDS_90316
IEEE1722RawDataStreamConsumer(IEEE1722RawDataStreamConsumer &&other) noexcept; SWS_RDS_90314

Destructor; an open connection is shut down.

~IEEE1722RawDataStreamConsumer() noexcept;

方法

Connect 函数

Connects the IEEE 1722 stream consumer.

ara::core::Result<void> Connect() noexcept;
Create 函数

Creates an IEEE 1722 consumer.

static ara::core::Result<IEEE1722RawDataStreamConsumer<T>> Create(const ara::core::InstanceSpecifier &instance) noexcept;
ReadData 函数

Reads IEEE 1722 datagrams.

ara::core::Result<std::vector<T>> ReadData(std::size_t maxNumberOfDatagrams) noexcept;
Shutdown 函数

Shuts down the consumer connection.

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

运算符

operator= 函数 2

Copy assignment operator is not allowed.

重载 = 2
IEEE1722RawDataStreamConsumer &operator=(const IEEE1722RawDataStreamConsumer &)=delete; SWS_RDS_90317
IEEE1722RawDataStreamConsumer &operator=(IEEE1722RawDataStreamConsumer &&other) & noexcept; SWS_RDS_90315

方法与类型文档

函数 IEEE1722RawDataStreamConsumer [SWS_RDS_90316]

IEEE1722RawDataStreamConsumer(const IEEE1722RawDataStreamConsumer &)=delete;

Copy constructor is not allowed.

Header-Datei#include "ara/rds/raw_data_stream_IEEE1722.h"
Scopeclass ara::rds::IEEE1722RawDataStreamConsumer

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

Record
AUTOSAR/AP/record/SWS_RDS_90316
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_RDS_90316@rel:R25-11#7436a79b
Content hash
7436a79b
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_RawDataStream.pdf#nameddest=SWS_RDS_90316
Status: valid/unmigrated Version: rel:R25-11#009f2d59 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_RDS_90316@rel:R25-11#009f2d59
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#5597a7ce2026-09-30
  • R24-11rel:R24-11#009f2d592026-10-14
  • R25-11rel:R25-11#009f2d592026-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

函数 IEEE1722RawDataStreamConsumer [SWS_RDS_90314]

IEEE1722RawDataStreamConsumer(IEEE1722RawDataStreamConsumer &&other) noexcept;

Move constructor.

Header-Datei#include "ara/rds/raw_data_stream_IEEE1722.h"
Scopeclass ara::rds::IEEE1722RawDataStreamConsumer
Thread-Sicherheitnot thread-safe

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

Record
AUTOSAR/AP/record/SWS_RDS_90314
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_RDS_90314@rel:R25-11#b612dbe3
Content hash
b612dbe3
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_RawDataStream.pdf#nameddest=SWS_RDS_90314
Status: valid/unmigrated Version: rel:R25-11#aa17951c 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_RDS_90314@rel:R25-11#aa17951c
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#3c97c8b92026-09-30
  • R24-11rel:R24-11#aa17951c2026-10-14
  • R25-11rel:R25-11#aa17951c2026-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_RDS_90317]

IEEE1722RawDataStreamConsumer &operator=(const IEEE1722RawDataStreamConsumer &)=delete;

Copy assignment operator is not allowed.

Header-Datei#include "ara/rds/raw_data_stream_IEEE1722.h"
Scopeclass ara::rds::IEEE1722RawDataStreamConsumer

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

Record
AUTOSAR/AP/record/SWS_RDS_90317
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_RDS_90317@rel:R25-11#71aa96bb
Content hash
71aa96bb
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_RawDataStream.pdf#nameddest=SWS_RDS_90317
Status: valid/unmigrated Version: rel:R25-11#b3ef9ada 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_RDS_90317@rel:R25-11#b3ef9ada
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#ce79784a2026-09-30
  • R24-11rel:R24-11#b3ef9ada2026-10-14
  • R25-11rel:R25-11#b3ef9ada2026-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_RDS_90315]

IEEE1722RawDataStreamConsumer &operator=(IEEE1722RawDataStreamConsumer &&other) & noexcept;

Move assignment operator.

Header-Datei#include "ara/rds/raw_data_stream_IEEE1722.h"
Scopeclass ara::rds::IEEE1722RawDataStreamConsumer
Thread-Sicherheitnot thread-safe

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

Record
AUTOSAR/AP/record/SWS_RDS_90315
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_RDS_90315@rel:R25-11#ba9c42b0
Content hash
ba9c42b0
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_RawDataStream.pdf#nameddest=SWS_RDS_90315
Status: valid/unmigrated Version: rel:R25-11#0d283cb5 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_RDS_90315@rel:R25-11#0d283cb5
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#dbaf01932026-09-30
  • R24-11rel:R24-11#0d283cb52026-10-14
  • R25-11rel:R25-11#0d283cb52026-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

函数 ~IEEE1722RawDataStreamConsumer [SWS_RDS_90318]

~IEEE1722RawDataStreamConsumer() noexcept;

Destructor; an open connection is shut down.

Header-Datei#include "ara/rds/raw_data_stream_IEEE1722.h"
Scopeclass ara::rds::IEEE1722RawDataStreamConsumer
Thread-Sicherheitnot thread-safe

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

Record
AUTOSAR/AP/record/SWS_RDS_90318
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_RDS_90318@rel:R25-11#f0dab66e
Content hash
f0dab66e
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_RawDataStream.pdf#nameddest=SWS_RDS_90318
Status: valid/unmigrated Version: rel:R25-11#dc5de02f 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_RDS_90318@rel:R25-11#dc5de02f
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#0c3787982026-09-30
  • R24-11rel:R24-11#dc5de02f2026-10-14
  • R25-11rel:R25-11#dc5de02f2026-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

函数 Connect [SWS_RDS_90319]

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

Connects the IEEE 1722 stream consumer.

Header-Datei#include "ara/rds/raw_data_stream_IEEE1722.h"
Scopeclass ara::rds::IEEE1722RawDataStreamConsumer

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

Record
AUTOSAR/AP/record/SWS_RDS_90319
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_RDS_90319@rel:R25-11#09d09a41
Content hash
09d09a41
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_RawDataStream.pdf#nameddest=SWS_RDS_90319
Status: valid/unmigrated Version: rel:R25-11#a4d312fc 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_RDS_90319@rel:R25-11#a4d312fc
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#1d0f02a72026-09-30
  • R24-11rel:R24-11#0defd1712026-10-14
  • R25-11rel:R25-11#a4d312fc2026-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

函数 ReadData [SWS_RDS_90321]

ara::core::Result<std::vector<T>> ReadData(std::size_t maxNumberOfDatagrams) noexcept;

Reads IEEE 1722 datagrams.

Header-Datei#include "ara/rds/raw_data_stream_IEEE1722.h"
Scopeclass ara::rds::IEEE1722RawDataStreamConsumer

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

Record
AUTOSAR/AP/record/SWS_RDS_90321
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_RDS_90321@rel:R25-11#4679a61a
Content hash
4679a61a
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_RawDataStream.pdf#nameddest=SWS_RDS_90321
Status: valid/unmigrated Version: rel:R25-11#ca000d62 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_RDS_90321@rel:R25-11#ca000d62
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#595b6c6e2026-09-30
  • R24-11rel:R24-11#ad0de5a62026-10-14
  • R25-11rel:R25-11#ca000d622026-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

函数 Shutdown [SWS_RDS_90320]

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

Shuts down the consumer connection.

Header-Datei#include "ara/rds/raw_data_stream_IEEE1722.h"
Scopeclass ara::rds::IEEE1722RawDataStreamConsumer

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

Record
AUTOSAR/AP/record/SWS_RDS_90320
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_RDS_90320@rel:R25-11#0dfe9b9b
Content hash
0dfe9b9b
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_RawDataStream.pdf#nameddest=SWS_RDS_90320
Status: valid/unmigrated Version: rel:R25-11#9025333d 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_RDS_90320@rel:R25-11#9025333d
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#97c9c7022026-09-30
  • R24-11rel:R24-11#c61b95152026-10-14
  • R25-11rel:R25-11#9025333d2026-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

函数 Create [SWS_RDS_90312]

static ara::core::Result<IEEE1722RawDataStreamConsumer<T>> Create(const ara::core::InstanceSpecifier &instance) noexcept;

Creates an IEEE 1722 consumer.

Header-Datei#include "ara/rds/raw_data_stream_IEEE1722.h"
Scopeclass ara::rds::IEEE1722RawDataStreamConsumer

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

Record
AUTOSAR/AP/record/SWS_RDS_90312
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_RDS_90312@rel:R25-11#d7cb36d2
Content hash
d7cb36d2
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_RawDataStream.pdf#nameddest=SWS_RDS_90312
Status: valid/unmigrated Version: rel:R25-11#2ac1bb80 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_RDS_90312@rel:R25-11#2ac1bb80
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#b2f202642026-09-30
  • R24-11rel:R24-11#5f959edc2026-10-14
  • R25-11rel:R25-11#2ac1bb802026-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