CoreDX DDS C Reference Manual
Public Attributes | List of all members
DDS_DomainParticipantListener Struct Reference

The DDS_DomainParticipantListener provides asynchronous notification of DDS_DomainParticipant events. More...

Public Attributes

void(* on_inconsistent_topic )(DDS_Topic the_topic, DDS_InconsistentTopicStatus status)
 
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)
 
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)
 
void(* on_data_on_readers )(DDS_Subscriber the_subscriber)
 

Detailed Description

The DDS_DomainParticipantListener provides asynchronous notification of DDS_DomainParticipant events.

This listener can be installed during DomainParticipant creation, DDS_DomainParticipantFactory_create_participant(), as well as by calling DDS_DomainParticipant_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_DomainParticipantListener::on_data_available) (DDS_DataReader the_reader)

on_data_available() is called when the CoreDX DDS middleware detects that a DataReader, contained in any Subscriber in this DomainParticipant, has new data or data state information available. This listener is invoked only if the concerned DDS_DataReader and DDS_Subscriber do not have an on_data_available listener installed.

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

void(* DDS_DomainParticipantListener::on_data_on_readers) (DDS_Subscriber the_subscriber)

on_data_on_readers() is called when the CoreDX DDS middleware detects that a DataReader, contained in any Subscriber in this DomainParticipant, has new data or data state information available. This listener is invoked only if the concerned DDS_Subscriber does not have an on_data_on_readers listener installed.

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

void(* DDS_DomainParticipantListener::on_inconsistent_topic) (DDS_Topic the_topic, DDS_InconsistentTopicStatus status)

on_inconsistent_topic() is called when the CoreDX DDS middleware detects that a Topic contained within this DomainParticipant has characteristics taht are different (inconsistent) with another existing topic. This listener is invoked only if the concerned DDS_Topic does not have an on_inconsistent_topic listener installed.

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

void(* DDS_DomainParticipantListener::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 DataWriter, matched to a DataReader within any Subscriber within this DomainParticipant, has changed (either 'active' or 'inactive'). This listener is invoked only if the concerned DDS_DataReader and DDS_Subscriber do not have an on_liveliness_changed listener installed.

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

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

on_liveliness_lost() is called when the CoreDX DDS middleware detects that a DataWriter contained in any Publisher within this DomainParticipant has not satisfied its LIVELINESS QoS setting. This listener is invoked only if the concerned DDS_DataWriter and DDS_Publisher do not have an on_liveliness_lost listener installed.

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

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

on_offered_deadline_missed() is called when the CoreDX DDS middleware detects that a DataWriter contained in any Publisher within this DomainParticipant has failed to meet its DEADLINE QoS commitment. This listener is invoked only if the concerned DDS_DataWriter and DDS_Publisher do 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_DomainParticipantListener::on_offered_incompatible_qos) (DDS_DataWriter writer, DDS_OfferedIncompatibleQosStatus status)

on_offered_incompatible_qos() is called when the CoreDX DDS middleware detects that a DataWriter contained in any Publisher within this DomainParticipant 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 and DDS_Publisher do not have an on_offered_incompatible_qos listener installed.

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

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

on_publication_matched() is called when the CoreDX DDS middleware detects that a DataWriter contained in any Publisher within this DomainParticipant has matched with a DataReader or has ceased to be matched with a DataReader. This listener is invoked only if the concerned DDS_DataWriter and DDS_Publisher do not have an on_publication_matched listener installed.

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

void(* DDS_DomainParticipantListener::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 QoS DEADLINE policy of a DataReader, contained in any Subscriber of this DomainParticipant, was not satisfied for a data instance. This listener is invoked only if the concerned DDS_DataReader and DDS_Subscriber do not have an on_requested_deadline_missed listener installed.

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

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

on_requested_incompatible_qos() is called when the CoreDX DDS middleware detects that a DataReader contained in any Subscriber within this DomainParticipant, has requested a QoS policy that was incompatible with that offered by a DataWriter. This listener is invoked only if the concerned DDS_DataReader and DDS_Subscriber do not have an on_requested_incompatible_qos listener installed.

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

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

on_sample_lost() is called when the CoreDX DDS middleware detects that a DataReader, contained in any Subscriber in this DomainParticipant, has lost a sample (never received). This listener is invoked only if the concerned DDS_DataReader and DDS_Subscriber do not have an on_sample_lost listener installed.

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

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

on_sample_rejected() is called when the CoreDX DDS middleware detects that a DataReader contained in any Subscriber within the DomainParticipan has rejected a sample. This listener is invoked only if the concerned DDS_DataReader and DDS_Subscriber do not have an on_sample_rejected listener installed.

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

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

on_subscription_matched() is called when the CoreDX DDS middleware detects that a DataReader, contained in any Subscriber in this DomainParticipant, has matched or ceased to be matched with a DataWriter. This listener is invoked only if the concerned DDS_DataReader and DDS_Subscriber do not have an on_subscription_matched listener installed.

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


© 2009-2017 Twin Oaks Computing, Inc
Castle Rock, CO 80108
All rights reserved.