Struct SampleInfo 

pub struct SampleInfo {
    pub sample_state: SampleStateKind,
    pub view_state: ViewStateKind,
    pub instance_state: InstanceStateKind,
    pub disposed_generation_count: i32,
    pub no_writers_generation_count: i32,
    pub sample_rank: i32,
    pub generation_rank: i32,
    pub absolute_generation_rank: i32,
    pub source_timestamp: Time,
    pub instance_handle: InstanceHandle,
    pub publication_handle: InstanceHandle,
    pub valid_data: bool,
}

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

Wird vom DataReader im take/read-Pfad gefuellt. Application- Code soll sich auf diese Felder verlassen, um:

• neue Samples vs. wiederholt gelesene zu unterscheiden (sample_state),
• neue Instanzen zu erkennen (view_state == NEW),
• Lifecycle-Events zu sehen (instance_state, valid_data == false),
• Reordering / Generations-Wechsel zu folgen (*_generation_count, *_rank).

Fields

sample_state: SampleStateKind

Sample-State (READ / NOT_READ).

view_state: ViewStateKind

View-State (NEW / NOT_NEW).

instance_state: InstanceStateKind

Instance-State (ALIVE / NOT_ALIVE_*).

disposed_generation_count: i32

Wieviele Mal die Instanz NOT_ALIVE_DISPOSED → ALIVE durchlaufen hat seit ihrem ersten Sample.

no_writers_generation_count: i32

Wieviele Mal die Instanz NOT_ALIVE_NO_WRITERS → ALIVE durchlaufen hat seit ihrem ersten Sample.

sample_rank: i32

Anzahl Samples in derselben Instanz, die nach diesem im Cache stehen (§2.2.2.5.1.5).

generation_rank: i32

Differenz generation_count zwischen diesem und dem letzten Sample der Instanz im selben Read-Set.

absolute_generation_rank: i32

Differenz generation_count zwischen diesem und dem aktuellen Generation-Count.

source_timestamp: Time

Wall-Clock-Zeitpunkt des write/dispose/unregister.

instance_handle: InstanceHandle

Lokaler Handle der Instanz.

publication_handle: InstanceHandle

Lokaler Handle des sendenden DataWriters (im offline / unbekannten Fall HANDLE_NIL).

valid_data: bool

true wenn das Sample Nutzdaten enthaelt; false bei reinem Dispose-/Unregister-Marker (§2.2.2.5.1.13).

Implementations

impl SampleInfo

pub fn new_alive( instance: InstanceHandle, publication: InstanceHandle, timestamp: Time, ) -> Self

Konstruiert einen Default-Info-Block fuer ein frisches Sample einer neuen Instanz mit valid_data = true.

pub fn matches_states( &self, sample_mask: u32, view_mask: u32, instance_mask: u32, ) -> bool

Prueft, ob dieses SampleInfo durch die uebergebenen State-Masks akzeptiert wird (Spec §2.2.2.5.3.1, read_w_condition).

Trait Implementations

impl Clone for SampleInfo

fn clone(&self) -> SampleInfo

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SampleInfo

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for SampleInfo

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for SampleInfo

fn eq(&self, other: &SampleInfo) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for SampleInfo

impl Eq for SampleInfo

impl StructuralPartialEq for SampleInfo