DDS_PublisherListener Struct Reference

The DDS_PublisherListener provides asynchronous notification of DDS_Publisher events. More...

Public Attributes
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_PublisherListener provides asynchronous notification of DDS_Publisher events.

This listener can be installed during Publisher creation DDS_DomainParticipant_create_publisher(), as well as by calling DDS_Publisher_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_PublisherListener::on_liveliness_lost) (DDS_DataWriter writer, DDS_LivelinessLostStatus status)

on_liveliness_lost() is called when the CoreDX DDS infrastructure detects that a DataWriter contained in the Publisher has not satisfied its LIVELINESS QoS setting. This listener is invoked only if the concerned DDS_DataWriter does not have an on_offered_deadline_missed listener installed.

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

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

on_offered_deadline_missed() is called when the CoreDX DDS infrastructure detects that a DataWriter contained in the Publisher has failed to meet its DEADLINE QoS commitment. This listener is invoked only if the concerned DDS_DataWriter does not have an on_offered_deadline_missed listener installed.

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

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

on_offered_incompatible_qos() is called when the CoreDX DDS infrastructure detects that a DataWriter contained in the Publisher has offered a QoS policy setting that is incompatible with that requested by a potentially matching DataReader. This listener is invoked only if the concerned DDS_DataWriter does not have an on_offered_deadline_missed listener installed.

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

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

on_publication_matched() is called when the CoreDX DDS infrastructure detects that a DataWriter contained in the Publisher has matched with a DataReader or has ceased to be matched with a DataReader. This listener is invoked only if the concerned DDS_DataWriter does not have an on_offered_deadline_missed listener installed.

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