Listener

The API used by a Transport Plugin to notify the NDDS core of dynamic changes in the Transport Plugin. More...

Data Structures
struct	NDDS_Transport_Listener
	Structure to hold callback functions that are invoked by a Transport-Plugin instance to notify that a dynamic change in the state of the Transport Plugin has occured. More...

Typedefs
typedef void(*	NDDS_Transport_Listener_Interface_Changed_Callback )(void *listener_data_in, NDDS_Transport_Plugin *plugin_in, NDDS_Transport_Interface_t *interface_changed_in)
	Callback invoked by the Transport-Plugin instance to notify that the number of interfaces that it can use has changed.

Detailed Description

The API used by a Transport Plugin to notify the NDDS core of dynamic changes in the Transport Plugin.

NDDS will register a structure, the NDDS_Transport_Listener, with a Transport Plugin. Then upon dynamic changes in the state of Transport Plugin, the plugin should call the appropriate function in the structure to inform NDDS of the change.

For example, if a Transport Plugin can dynamically detect when interfaces that it manages are enabled/disabled, appear or disappear, as they might in IP-based transports when NIC cards are enabled/disabled or are attached and deattached, then the plugin should let NDDS know that this has happened to give NDDS the chance to use these new interfaces or stop using lost interfaces for communications.

Attention

This functionality has not yet been implemented by the NDDS core. That is, the NDDS core is not capable of taking actions based on dynamic changes in a Transport Plugin. Thus it will never register a listener with a Transport Plugin (Mar 2005).

Typedef Documentation

typedef void(* NDDS_Transport_Listener_Interface_Changed_Callback)(void *listener_data_in, NDDS_Transport_Plugin *plugin_in, NDDS_Transport_Interface_t *interface_changed_in)

Callback invoked by the Transport-Plugin instance to notify that the number of interfaces that it can use has changed.

Parameters

listener_data_in	<<in>> The listener data.
plugin_in	<<in>> The Transport-Plugin instance that invoked this callback.
interface_changed_in	<<in>> The changed interface that trigger the callback.

MT Safety:

Multithread Safe The implementor of this callback must ensure that it is multi-thread safe, so that callers (Transport-Plugin instances) don't have to worry about multithreaded safety issues.