Message Listeners

Detailed Description

Provides functions to intercept messages received if the devices are not used.

Collaboration diagram for Message Listeners:

Functions
int	gxPLMessageListenerAdd (gxPLApplication *app, gxPLMessageListener listener, void *udata)
	Add a message listener. More...
int	gxPLMessageListenerRemove (gxPLApplication *app, gxPLMessageListener listener)
	Remove a message listener. More...

Typedefs
typedef void(*	gxPLMessageListener) (gxPLApplication *app, gxPLMessage *, void *)
	Function that will be called each valid message reception.

Function Documentation

int gxPLMessageListenerAdd	(	gxPLApplication *	app,
		gxPLMessageListener	listener,
		void *	udata
	)

Add a message listener.

Parameters

app	pointer to a gxPLApplication object
listener	function that will be called each message reception.
udata	pointer to the data passed to the listener

Returns

0, -1 if an error occurs

Examples:

logger/gxpl-logger.c.

int gxPLMessageListenerRemove	(	gxPLApplication *	app,
		gxPLMessageListener	listener
	)

Remove a message listener.

Parameters

app	pointer to a gxPLApplication object
listener	the listener to remove

Returns

0, -1 if an error occurs