DDS_DataWriterListener Struct Reference

The DDS_DataWriterListener provides asynchronous notification of DDS_DataWriter events. More...

Data Fields
void(*	on_offered_deadline_missed )(DDS_DataWriter writer, DDS_OfferedDeadlineMissedStatus status)
void(*	on_offered_incompatible_qos )(DDS_DataWriter writer, DDS_OfferedIncompatibleQosStatus status)
void(*	on_liveliness_lost )(DDS_DataWriter writer, DDS_LivelinessLostStatus status)
void(*	on_publication_matched )(DDS_DataWriter writer, DDS_PublicationMatchedStatus status)

Detailed Description

The DDS_DataWriterListener provides asynchronous notification of DDS_DataWriter events.

This listener can be installed during DataWriter creation, DDS_Publisher_create_datawriter(), as well as by calling DDS_DataWriter_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.

Field Documentation

on_liveliness_lost

void(* DDS_DataWriterListener::on_liveliness_lost) (DDS_DataWriter writer, DDS_LivelinessLostStatus status)

on_liveliness_lost() is called when the CoreDX DDS infrastructure detects that the DataWriter has not satisfied its LIVELINESS QoS setting.

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

on_offered_deadline_missed

void(* DDS_DataWriterListener::on_offered_deadline_missed) (DDS_DataWriter writer, DDS_OfferedDeadlineMissedStatus status)

on_offered_deadline_missed() is called when the CoreDX DDS infrastructure detects that the deadline that the DDS_DataWriter has offered Through the DEADLINE QoS was not satisfied. That is, the DataWriter has failed to update an instance with the frequency specified in the DEADLINE QoS.

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

on_offered_incompatible_qos

void(* DDS_DataWriterListener::on_offered_incompatible_qos) (DDS_DataWriter writer, DDS_OfferedIncompatibleQosStatus status)

on_offered_incompatible_qos() is called when the CoreDX DDS infrastructure detects that the DataWriter has offered a QoS policy setting that is incompatible with that requested by a potentially matching DataReader.

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

on_publication_matched

void(* DDS_DataWriterListener::on_publication_matched) (DDS_DataWriter writer, DDS_PublicationMatchedStatus status)

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

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