DEENESPTFRRUARHIKOZHNL

class ara::rds::IEEE1722Datagram

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_90225] · Header ara/rds/raw_data_stream_IEEE1722.h

class IEEE1722Datagram {...};

IEEE 1722 datagram representation: IEEE1722Datagram.

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

User GuideKI-GENERIERT

Dient als Basisklasse zur Kapselung von IEEE-1722-Nutzdatenpuffern und Längenangaben im Raw-Data-Streaming.
KI-GENERIERT ungeprüft Modell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: 187f3b1b82dd Herkunft Offene Fragen (2)
KI-generiertgemini-3.8-flash-medium · 2026-10-13

Dient als Basisklasse zur Kapselung von IEEE-1722-Nutzdatenpuffern und Längenangaben im Raw-Data-Streaming.

Die Klasse ara::rds::IEEE1722Datagram dient im Modul rds als Basisklasse zur Kapselung von IEEE-1722-Streaming-Datagrammen (AUTOSAR_AP_SWS_RawDataStream S. 1). Sie verwaltet über das geschützte Attribut data den dynamischen Byte-Puffer im exklusiven Besitz und hält mit stream_data_length die jeweilige Nutzdatenlänge vor. Die Freigabe der allokierten Pufferressourcen erfolgt deterministisch und ausnahmefrei über den virtuellen Destruktor ~IEEE1722Datagram() [SWS_RDS_90228]. Eine interne Synchronisation für nebenläufige Zugriffe existiert nicht, sodass threadübergreifende Nutzungen extern abgesichert werden müssen.

Kontext

Die Klasse ara::rds::IEEE1722Datagram fungiert im Modul rds (Raw Data Stream) der AUTOSAR Adaptive Platform als Basisrepräsentation für Datagramme nach dem IEEE-1722-Standard (AUTOSAR_AP_SWS_RawDataStream S. 1). Sie wird über den Header ara/rds/raw_data_stream_IEEE1722.h deklariert und dient als strukturelles Fundament für den Transport zeitkritischer Streaming-Daten im Fahrzeugnetzwerk, insbesondere über das Audio Video Transport Protocol (AVTP).

Interpretation: Durch die Bereitstellung geschützter Attribute und eines virtuellen Destruktors dürfte ara::rds::IEEE1722Datagram als gemeinsame Basisklasse für verschiedene spezialisierte AVTP-Datagrammstrukturen dienen. Frage Q-bb382ff193640c8f (offen) Die Spezifikation definiert in diesem Kontext verwandte Typen wie IEEE1722DatagramAVTPDUCommonHeaderFields [SWS_RDS_90233], IEEE1722DatagramAVTPDUCommonStreamHeaderFields [SWS_RDS_90242], IEEE1722Datagram61883_IIDC [SWS_RDS_90260], IEEE1722DatagramAAF [SWS_RDS_90273] sowie IEEE1722DatagramTSCF [SWS_RDS_90275]. Diese Interaktionspartner bilden gemeinsam das Protokollgerüst für unterschiedliche Payload-Formate ab.

diag_kontext IEEE1722Datagram IEEE1722Datagram IEEE1722DatagramAVTPDUCommonHeaderFields IEEE1722DatagramAVTPDUCommonHeaderFields IEEE1722Datagram->IEEE1722DatagramAVTPDUCommonHeaderFields IEEE1722DatagramAVTPDUCommonStreamHeaderFields IEEE1722DatagramAVTPDUCommonStreamHeaderFields IEEE1722DatagramAVTPDUCommonHeaderFields->IEEE1722DatagramAVTPDUCommonStreamHeaderFields IEEE1722DatagramAAF IEEE1722DatagramAAF IEEE1722DatagramAVTPDUCommonStreamHeaderFields->IEEE1722DatagramAAF IEEE1722DatagramTSCF IEEE1722DatagramTSCF IEEE1722DatagramAVTPDUCommonStreamHeaderFields->IEEE1722DatagramTSCF IEEE1722Datagram61883_IIDC IEEE1722Datagram61883_IIDC IEEE1722DatagramAVTPDUCommonStreamHeaderFields->IEEE1722Datagram61883_IIDC

Kontextdiagramm: Einordnung von ara::rds::IEEE1722Datagram und spezialisierten AVTP-Datagrammstrukturen. Quellen: [SWS_RDS_90226], [SWS_RDS_90228], [SWS_RDS_90233], [SWS_RDS_90242], [SWS_RDS_90260], [SWS_RDS_90273], [SWS_RDS_90275]

Lebenszyklus

Der Lebenszyklus einer Datagramm-Instanz wird maßgeblich durch die Verwaltung des zugehörigen Datenpuffers und das RAII-Paradigma bestimmt. Das Attribut data ist als std::unique_ptr<ara::core::Byte[]> geschützt deklariert [SWS_RDS_90226]. Dies etabliert ein exklusives Besitzverhältnis: Ein Datagramm besitzt seinen Byte-Puffer exklusiv, wodurch unbeabsichtigtes Kopieren großer Datenmengen auf Typ-Ebene unterbunden wird.

Zusammen mit dem Puffer wird die Länge der gültigen Nutzdaten über das geschützte Feld stream_data_length vom Typ std::uint16_t geführt [SWS_RDS_90227]. Die Freigabe der Ressourcen erfolgt deterministisch: Die Klasse stellt einen virtuellen Destruktor ~IEEE1722Datagram() noexcept bereit [SWS_RDS_90228]. Dieser stellt sicher, dass bei der Zerstörung abgeleiteter Instanzen über einen Zeiger auf die Basisklasse sämtliche Ressourcen vollständig und ohne Speicherlecks freigegeben werden.

Hinsichtlich der Nebenläufigkeit enthält die Basisklasse keine internen Synchronisationsmechanismen. Vermutlich erfordert der gleichzeitige Zugriff auf dieselbe Datagramm-Instanz aus mehreren Threads eine externe Koordination durch die anwendende Komponente. Frage (offen)

Nutzungspfad

In einem typischen Verarbeitungsablauf innerhalb des Raw-Data-Streamings erfolgt die Nutzung über konkrete Protokollausprägungen wie IEEE1722DatagramAAF [SWS_RDS_90273] oder IEEE1722DatagramTSCF [SWS_RDS_90275]:

  • Erzeugung und Pufferallokation: Eine spezialisierte Datagramm-Instanz wird instanziiert, und der geschützte Datenpuffer data wird als std::unique_ptr<ara::core::Byte[]> mit dem erforderlichen Speicherbereich initialisiert [SWS_RDS_90226].
  • Längenfestlegung: Die tatsächliche Nutzdatenlänge des Streams wird in stream_data_length hinterlegt [SWS_RDS_90227].
  • Übergabe und Verarbeitung: Interpretation: Das Datagramm dürfte vorzugsweise mittels Move-Semantik durch die Verarbeitungspipeline des Moduls rds transportiert werden, um unnötige Kopieroperationen von Streaming-Daten zu vermeiden. Frage Q-ff084c9788ec5cdc (offen)
  • Zerstörung: Nach Abschluss der Verarbeitung verlässt das Datagramm seinen Gültigkeitsbereich; der virtuelle Destruktor ~IEEE1722Datagram() wird aufgerufen und der Puffer automatisch deallokiert [SWS_RDS_90228].

Fehlerszenarien

Fehler im Umgang mit ara::rds::IEEE1722Datagram können insbesondere bei der Speicherverwaltung und Grenzwertprüfung auftreten:

  • Speicherallokationsfehler: Schlägt die Allokation des dynamischen Byte-Arrays für data fehl, kann dies zu einer Standard-Speicherausnahme (std::bad_alloc) führen, bevor das Datagramm gültig bereitgestellt wird [SWS_RDS_90226].
  • Längeninkonsistenz: Wird für stream_data_length ein Wert eingetragen, der die reale Größe des über data allokierten Speichers überschreitet, drohen bei lesenden Zugriffen Pufferüberläufe [SWS_RDS_90227]. Abgeleitete Klassen müssen die Konsistenz zwischen Pufferallokation und Längenangabe sicherstellen.
  • Ausnahmesicherheit beim Abbau: Der Destruktor ist explizit als noexcept deklariert [SWS_RDS_90228]. Dadurch ist garantiert, dass bei der Zerstörung des Objekts keine Ausnahmen propagiert werden, was für die Stabilität von RAII-Ketten essenziell ist.

Dieser Leitfaden wurde durch eine KI auf Basis der Spezifikation AUTOSAR Adaptive R25-11 generiert.

Mitgliederkarte

Konstruktoren und Destruktor

1

Detailansicht

Wähle in der Gliederung einen Eintrag aus.

Konstruktoren und Destruktor

Virtual destructor of the IEEE 1722 datagram type.

~IEEE1722Datagram() noexcept;

Konstanten

data variable

Protected IEEE 1722 datagram field data.

std::unique_ptr<ara::core::Byte[]> data;

Protected IEEE 1722 datagram field stream_data_length.

std::uint16_t stream_data_length;

Dokumentation der Methoden und Typen

variable data [SWS_RDS_90226]

std::unique_ptr<ara::core::Byte[]> data;

Protected IEEE 1722 datagram field data.

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

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

Record
AUTOSAR/AP/record/SWS_RDS_90226
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_RDS_90226@rel:R25-11#036fe33b
Content hash
036fe33b
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_RawDataStream.pdf#nameddest=SWS_RDS_90226
Status: valid/unmigrated Version: rel:R25-11#cd433d90 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_90226@rel:R25-11#cd433d90
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#036fe33b2026-09-30
  • R24-11rel:R24-11#cd433d902026-10-14
  • R25-11rel:R25-11#cd433d902026-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

variable stream_data_length [SWS_RDS_90227]

std::uint16_t stream_data_length;

Protected IEEE 1722 datagram field stream_data_length.

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

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

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

function ~IEEE1722Datagram [SWS_RDS_90228]

~IEEE1722Datagram() noexcept;

Virtual destructor of the IEEE 1722 datagram type.

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

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

Record
AUTOSAR/AP/record/SWS_RDS_90228
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_RDS_90228@rel:R25-11#df2abe81
Content hash
df2abe81
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_RawDataStream.pdf#nameddest=SWS_RDS_90228
Status: valid/unmigrated Version: rel:R25-11#4395c8db 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_90228@rel:R25-11#4395c8db
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#df2abe812026-09-30
  • R24-11rel:R24-11#d950a3602026-10-14
  • R25-11rel:R25-11#4395c8db2026-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