DEENESPTFRRUARHIKOZHNL

classe 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

Guia do utilizadorGERADO POR IA

Recebe datagramas de streaming IEEE 1722 tipados por meio de um ponto de extremidade de comunicação configurado.
GERADO POR IA não revisado Modelo: gemini-3.8-flash-medium · Esforço: medium · Temperatura: não controlável · Prompt: e1b5fefad19b Procedência Perguntas em aberto (2)
traduzido do guia alemãogemini-3.8-flash-low · 2026-10-13 · Original em alemão

Recebe datagramas de streaming IEEE 1722 tipados por meio de um ponto de extremidade de comunicação configurado.

A classe de template ara::rds::IEEE1722RawDataStreamConsumer serve para a recepção tipada de datagramas de streaming IEEE 1722 na AUTOSAR Adaptive Platform. As instâncias são criadas por meio do método estático Create() com um InstanceSpecifier [SWS_RDS_90312] e, em seguida, conectadas ao fluxo de dados por meio de Connect(). Por meio do método ReadData(), datagramas recebidos podem ser lidos até uma quantidade máxima predefinida [SWS_RDS_90321]. Operações de cópia são excluídas, de modo que a conexão pode ser transmitida exclusivamente por operações move, cuja execução não é thread-safe.

Contexto

A classe de template ara::rds::IEEE1722RawDataStreamConsumer funciona como um receptor tipado para datagramas de streaming IEEE 1722 dentro do módulo de fluxo de dados brutos (rds) da AUTOSAR Adaptive Platform. Por meio do parâmetro de template T, define-se o tipo de dados úteis concreto dos datagramas. A classe encapsula o acesso ao fluxo de dados e vincula os pontos de extremidade de comunicação à infraestrutura de comunicação configurada por meio de um identificador do tipo ara::core::InstanceSpecifier [SWS_RDS_90312]. Aplicações utilizam este consumer para receber fluxos de dados úteis estruturados AVTP ou IEEE 1722 de forma direta e com eficiência de recursos.

Ciclo de vida

A instanciação de um consumer ocorre exclusivamente por meio do método de fábrica estático Create() [SWS_RDS_90312], especificando a instância de destino. Uma chamada direta ao construtor não é prevista para usuários. A classe implementa uma semântica estrita move-only: a cópia de instâncias é explicitamente proibida, já que tanto o construtor de cópia [SWS_RDS_90316] quanto o operador de atribuição por cópia [SWS_RDS_90317] estão excluídos. Isso garante que a conexão subjacente e os recursos de buffer permaneçam sempre sob posse exclusiva.

Para permitir transferências de posse entre contextos, a classe disponibiliza um construtor move [SWS_RDS_90314], bem como um operador de atribuição move [SWS_RDS_90315]. Ambas as operações move são declaradas como não thread-safe, razão pela qual acessos concorrentes à mesma instância devem ser sincronizados. Ao desalocar a instância, o destrutor ~IEEE1722RawDataStreamConsumer() fecha automaticamente uma conexão eventualmente ainda existente [SWS_RDS_90318]; o destrutor também é especificado como não thread-safe.

Caminho de utilização

O fluxo típico no uso de um IEEE1722RawDataStreamConsumer compreende quatro fases consecutivas:

  1. Criação: a aplicação cria a instância do consumer por meio do método de fábrica Create() com o ara::core::InstanceSpecifier desejado [SWS_RDS_90312].
  2. Estabelecimento da conexão: antes da recepção de dados úteis, a aplicação conecta o consumer ao fluxo de dados configurado chamando Connect() [SWS_RDS_90319].
  3. Recepção de dados: a aplicação chama ReadData() repetidamente ou de forma cíclica [SWS_RDS_90321]. O parâmetro maxNumberOfDatagrams indica a quantidade máxima de datagramas a serem consultados na chamada. O resultado é retornado como um vetor do tipo de template T.
  4. Encerramento da conexão: após a conclusão da transmissão de dados, a aplicação encerra a conexão explicitamente por meio de Shutdown() [SWS_RDS_90320] ou deixa a limpeza a cargo do destrutor [SWS_RDS_90318].
Nutzungsablauf IEEE1722RawDataStreamConsumerAplicaçãoIEEE1722RawDataStreamConsumerCreate(instance)Result<IEEE1722RawDataStreamConsumer<T>>Connect()Result<void>loopEnquanto dados forem recebidosReadData(maxNumberOfDatagrams)Result<std::vector<T>>Shutdown()Result<void>

Diagrama de sequência: caminho de uso típico para criação, conexão, consulta cíclica de datagramas e encerramento do consumer. Fontes: [SWS_RDS_90312], [SWS_RDS_90319], [SWS_RDS_90321], [SWS_RDS_90320], [SWS_RDS_90318].

Cenários de erro

Todas as funções de interface regulares da classe — Create() [SWS_RDS_90312], Connect() [SWS_RDS_90319], ReadData() [SWS_RDS_90321] e Shutdown() [SWS_RDS_90320] — são qualificadas com noexcept e não sinalizam estados de erro por meio de exceções C++, mas sim por meio do tipo de retorno ara::core::Result. Aplicações precisam, portanto, verificar se o respectivo resultado contém um valor ou um erro antes de acessar valores de dados ou antes de operações subsequentes.

Possíveis constelações de erro incluem a falha na criação da instância, caso a configuração do InstanceSpecifier esteja incorreta, bem como interrupções de conexão ou erros no acesso à rede durante Connect() ou ReadData(). Interpretação: uma chamada de ReadData() provavelmente pressupõe que um estabelecimento de conexão bem-sucedido tenha sido concluído previamente por meio de Connect(). Pergunta Q-ea5241fe8b3e95a8 (aberta) Causas concretas de erro provavelmente são transportadas de forma idiomática como códigos de erro no ara::core::Result retornado.

Este guia foi gerado por um sistema de IA com base na especificação AUTOSAR Adaptive Platform Release R25-11.

Mapa de membros

Vista de detalhes

Selecione uma entrada no índice.

Construtores e destrutor

Copy constructor is not allowed.

Sobrecargas 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;

Métodos

Connect função

Connects the IEEE 1722 stream consumer.

ara::core::Result<void> Connect() noexcept;
Create função

Creates an IEEE 1722 consumer.

static ara::core::Result<IEEE1722RawDataStreamConsumer<T>> Create(const ara::core::InstanceSpecifier &instance) noexcept;
ReadData função

Reads IEEE 1722 datagrams.

ara::core::Result<std::vector<T>> ReadData(std::size_t maxNumberOfDatagrams) noexcept;
Shutdown função

Shuts down the consumer connection.

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

Operadores

operator= função 2

Copy assignment operator is not allowed.

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

Documentação dos métodos e tipos

função 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#923579a2
Content hash
923579a2
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

função 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#ecec25f6
Content hash
ecec25f6
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

função 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#42a8c398
Content hash
42a8c398
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

função 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#53b9f5ed
Content hash
53b9f5ed
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

função ~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#3971c020
Content hash
3971c020
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

função 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#8a2c0267
Content hash
8a2c0267
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

função 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#d180f1f3
Content hash
d180f1f3
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

função 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#5d631bd9
Content hash
5d631bd9
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

função 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#5a65ffc1
Content hash
5a65ffc1
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