RTI Connext Micro C API  2.4.14.2
 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Groups
DDS_DomainParticipantListener Struct Reference

<<interface>> <<cert>> Listener for participant status. More...

Data Fields

struct DDS_TopicListener as_topiclistener
 A superclass instance of this DDS_DomainParticipantListener.
struct DDS_PublisherListener as_publisherlistener
 A superclass instance of this DDS_DomainParticipantListener.
struct DDS_SubscriberListener as_subscriberlistener
 A superclass instance of this DDS_DomainParticipantListener.

Detailed Description

<<interface>> <<cert>> Listener for participant status.

Entity:
DDS_DomainParticipant
Status:
Status Kinds

This is the interface that can be implemented by an application-provided class and then registered with the DDS_DomainParticipant such that the application can be notified by RTI Connext Micro of relevant status changes.

The DDS_DomainParticipantListener interface extends all other Listener interfaces and has no additional operation beyond the ones defined by the more general listeners.

The purpose of the DDS_DomainParticipantListener is to be the listener of last resort that is notified of all status changes not captured by more specific listeners attached to the DDS_DomainEntity objects. When a relevant status change occurs, RTI Connext Micro will first attempt to notify the listener attached to the concerned DDS_DomainEntity if one is installed. Otherwise, RTI Connext Micro will notify the Listener attached to the DDS_DomainParticipant.

Important: Because a DDS_DomainParticipantListener may receive callbacks pertaining to many different entities, it is possible for the same listener to receive multiple callbacks simultaneously in different threads. (Such is not the case for listeners of other types.) It is therefore critical that users of this listener provide their own protection for any thread-unsafe activities undertaken in a DDS_DomainParticipantListener callback.

See also:
DDS_Listener
DDS_DomainParticipant_set_listener

Field Documentation

struct DDS_TopicListener DDS_DomainParticipantListener::as_topiclistener

A superclass instance of this DDS_DomainParticipantListener.

struct DDS_PublisherListener DDS_DomainParticipantListener::as_publisherlistener

A superclass instance of this DDS_DomainParticipantListener.

struct DDS_SubscriberListener DDS_DomainParticipantListener::as_subscriberlistener

A superclass instance of this DDS_DomainParticipantListener.


RTI Connext Micro C API 2.4.14.2 Copyright © Tue May 28 2024 Real-Time Innovations, Inc