Skip to main content

Module sample_info

zerodds_dcps

Module sample_info 

Source
Expand description

SampleInfo — Metadaten pro Sample, die DataReader::read/take mit jedem Sample mitliefern.

Spec-Referenz: OMG DDS-DCPS 1.4 §2.2.2.5.1 SampleInfo. Die Spec definiert 11 Felder, die zusammen das Statechart eines Samples beschreiben:

  1. sample_state: ob der Reader das Sample schon einmal gelesen hat (READ) oder nicht (NOT_READ).
  2. view_state: ob die Reader-Instanz neu ist (NEW) oder schon bekannt (NOT_NEW).
  3. instance_state: Lifecycle-Zustand der Instanz (ALIVE, NOT_ALIVE_DISPOSED, NOT_ALIVE_NO_WRITERS).
  4. disposed_generation_count: Anzahl der Uebergaenge NOT_ALIVE_DISPOSED → ALIVE seit dem ersten Sample dieser Instanz.
  5. no_writers_generation_count: Anzahl der Uebergaenge NOT_ALIVE_NO_WRITERS → ALIVE seit dem ersten Sample dieser Instanz.
  6. sample_rank: Anzahl Samples in derselben Instanz, die nach diesem im Cache stehen (Spec §2.2.2.5.1.5).
  7. generation_rank: Differenz der Generation-Counts zwischen diesem und dem letzten Sample der Instanz im selben Read-Set.
  8. absolute_generation_rank: wie generation_rank, aber relativ zum aktuellen Generation-Count.
  9. source_timestamp: Wall-Clock-Zeitpunkt der Schreiboperation.
  10. instance_handle: lokaler Handle der Instanz (Key-basiert).
  11. publication_handle: lokaler Handle des sendenden DataWriters.
  12. valid_data: false fuer Dispose-/Unregister-Markers ohne Nutzdaten (Spec §2.2.2.5.1.13).

Hinweis: die Spec listet valid_data als 12. Feld; einige Texte zaehlen es nicht mit, daher findet man sowohl “11” als auch “12” Felder in der Doku. Wir tragen alle.

Modules§

instance_state_mask
Bitmask-Maske fuer Instance-State-Filter (§2.2.2.5.1.4 InstanceStateMask).
sample_state_mask
Bitmask-Maske fuer Sample-State-Filter in read/take-Calls (DDS 1.4 §2.2.2.5.1.4 SampleStateMask).
view_state_mask
Bitmask-Maske fuer View-State-Filter (§2.2.2.5.1.4 ViewStateMask).

Structs§

SampleInfo
SampleInfo (DDS 1.4 §2.2.2.5.1) — Metadaten pro Sample.

Enums§

InstanceStateKind
InstanceStateKind (DDS 1.4 §2.2.2.5.1.3) — pro Instanz gepflegt.
SampleStateKind
SampleStateKind (DDS 1.4 §2.2.2.5.1.1) — pro Reader gepflegt.
ViewStateKind
ViewStateKind (DDS 1.4 §2.2.2.5.1.2) — pro Instanz gepflegt.