DDS_DataReaderListener Struct Reference
[DDS Listeners]

The DDS_DataReaderListener provides asynchronous notification of DDS_DataReader events. More...

List of all members.

Public Attributes
void(*	on_requested_deadline_missed )(DDS_DataReader the_reader, DDS_RequestedDeadlineMissedStatus status)
void(*	on_requested_incompatible_qos )(DDS_DataReader the_reader, DDS_RequestedIncompatibleQosStatus status)
void(*	on_sample_rejected )(DDS_DataReader the_reader, DDS_SampleRejectedStatus status)
void(*	on_liveliness_changed )(DDS_DataReader the_reader, DDS_LivelinessChangedStatus status)
void(*	on_data_available )(DDS_DataReader the_reader)
void(*	on_subscription_matched )(DDS_DataReader the_reader, DDS_SubscriptionMatchedStatus status)
void(*	on_sample_lost )(DDS_DataReader the_reader, DDS_SampleLostStatus status)

---

Detailed Description

The DDS_DataReaderListener provides asynchronous notification of DDS_DataReader events.

This listener can be installed during DataReader creation, DDS_Subscriber_create_datareader(), as well as by calling DDS_DataReader_set_listener().

Note:

The listener callback methods should be lightweight and should not block. If a callback method blocks, it will block all other callback operations within the same DomainParticipant.

---

Member Data Documentation

void(* DDS_DataReaderListener::on_data_available)(DDS_DataReader the_reader)

on_data_available() is called when the CoreDX DDS middleware detects that new data or data state information is available.

The status argument provides a snapshot of the status at the time the listener was invoked.

void(* DDS_DataReaderListener::on_liveliness_changed)(DDS_DataReader the_reader, DDS_LivelinessChangedStatus status)

on_liveliness_changed() is called when the CoreDX DDS middleware detects that the liveliness of a matched DataWriter has changed (either 'active' or 'inactive').

The status argument provides a snapshot of the status at the time the listener was invoked.

void(* DDS_DataReaderListener::on_requested_deadline_missed)(DDS_DataReader the_reader, DDS_RequestedDeadlineMissedStatus status)

on_requested_deadline_missed() is called when the CoreDX DDS middleware detects that the deadline specified in the DataReader QoS DEADLINE policy was not satisfied for a data instance.

The status argument provides a snapshot of the status at the time the listener was invoked.

void(* DDS_DataReaderListener::on_requested_incompatible_qos)(DDS_DataReader the_reader, DDS_RequestedIncompatibleQosStatus status)

on_requested_incompatible_qos() is called when the CoreDX DDS middleware detects that the DataReader requested a QoS policy that was incompatible with that offered by a DataWriter.

The status argument provides a snapshot of the status at the time the listener was invoked.

void(* DDS_DataReaderListener::on_sample_lost)(DDS_DataReader the_reader, DDS_SampleLostStatus status)

on_sample_lost() is called when the CoreDX DDS middleware detects that a sample has been lost (never received).

The status argument provides a snapshot of the status at the time the listener was invoked.

void(* DDS_DataReaderListener::on_sample_rejected)(DDS_DataReader the_reader, DDS_SampleRejectedStatus status)

on_sample_rejected() is called when the CoreDX DDS middleware detects that a sample has been rejected.

The status argument provides a snapshot of the status at the time the listener was invoked.

void(* DDS_DataReaderListener::on_subscription_matched)(DDS_DataReader the_reader, DDS_SubscriptionMatchedStatus status)

on_subscription_matched() is called when the CoreDX DDS middleware detects that the DataReader has matched or ceased to be matched with a DataWriter.

The status argument provides a snapshot of the status at the time the listener was invoked.