RTI Connext C API Version 7.3.0

DDS_InstanceStateKind and associated elements More...

Typedefs

typedef DDS_UnsignedLong DDS_InstanceStateMask
 A bit-mask (list) of instance states, i.e. DDS_InstanceStateKind. More...
 

Enumerations

enum  DDS_InstanceStateKind {
  DDS_ALIVE_INSTANCE_STATE = 0x0001 << 0 ,
  DDS_NOT_ALIVE_DISPOSED_INSTANCE_STATE = 0x0001 << 1 ,
  DDS_NOT_ALIVE_NO_WRITERS_INSTANCE_STATE = 0x0001 << 2
}
 Indicates if the samples are from a live DDS_DataWriter or not. More...
 

Variables

const DDS_InstanceStateMask DDS_ANY_INSTANCE_STATE
 Any instance state ALIVE_INSTANCE_STATE | NOT_ALIVE_DISPOSED_INSTANCE_STATE | NOT_ALIVE_NO_WRITERS_INSTANCE_STATE. More...
 
const DDS_InstanceStateMask DDS_NOT_ALIVE_INSTANCE_STATE
 Not alive instance state NOT_ALIVE_DISPOSED_INSTANCE_STATE | NOT_ALIVE_NO_WRITERS_INSTANCE_STATE. More...
 

Detailed Description

DDS_InstanceStateKind and associated elements

Typedef Documentation

◆ DDS_InstanceStateMask

A bit-mask (list) of instance states, i.e. DDS_InstanceStateKind.

Enumeration Type Documentation

◆ DDS_InstanceStateKind

Indicates if the samples are from a live DDS_DataWriter or not.

For each instance, the middleware internally maintains an instance state. The instance state can be:

  • DDS_ALIVE_INSTANCE_STATE indicates that (a) samples have been received for the instance, (b) there are live DDS_DataWriter entities writing the instance, and (c) the instance has not been explicitly disposed (or else more samples have been received after it was disposed).

The precise behavior events that cause the instance state to change depends on the setting of the OWNERSHIP QoS:

The instance state available in the DDS_SampleInfo is a snapshot of the instance state of the instance at the time the collection was obtained (i.e. at the time read or take was called). The instance state is therefore the same for all samples in the returned collection that refer to the same instance.

Enumerator
DDS_ALIVE_INSTANCE_STATE 

Instance is currently in existence.

DDS_NOT_ALIVE_DISPOSED_INSTANCE_STATE 

Not alive disposed instance. The instance has been disposed by a DataWriter.

DDS_NOT_ALIVE_NO_WRITERS_INSTANCE_STATE 

Not alive no writers for instance. None of the DDS_DataWriter objects that are currently alive (according to the LIVELINESS) are writing the instance.

Variable Documentation

◆ DDS_ANY_INSTANCE_STATE

const DDS_InstanceStateMask DDS_ANY_INSTANCE_STATE
extern

Any instance state ALIVE_INSTANCE_STATE | NOT_ALIVE_DISPOSED_INSTANCE_STATE | NOT_ALIVE_NO_WRITERS_INSTANCE_STATE.

Examples
HelloWorld_subscriber.c.

◆ DDS_NOT_ALIVE_INSTANCE_STATE

const DDS_InstanceStateMask DDS_NOT_ALIVE_INSTANCE_STATE
extern

Not alive instance state NOT_ALIVE_DISPOSED_INSTANCE_STATE | NOT_ALIVE_NO_WRITERS_INSTANCE_STATE.