grtGetEvent( )

Description | Example

Name:	int grtGetEvent (int start_chan, int end_chan, GRT_EVENT *event)
Inputs:	int start_chan	Integer representing the first channel to control.
	int end_chan	Integer representing the last channel to control.
	GRT_EVENT *event	Pointer to GRT_EVENT.
Outputs:	GRT_EVENT *event	Pointer to GRT_EVENT.
Returns:	GRT_SUCCESS	Successful.
	GRT_INVALID_START_ CHANNEL	Starting channel is out of range.
	GRT_INVALID_END_ CHANNEL	Ending channel is out of range.
	GRT_NO_DISPATCHER	Dispatcher is not running.
	GRT_NO_EVENT	No event has occurred.
	GRT_UNKNOWN_EVENT	Unknown event polled from board.
	GRT_NOT_INIT	The specified channel has not been grtInit by any process or thread.
	GRT_ANOTHER_THREAD	The specified channel has been grtInit by another process or thread (not this one).
	GRT_CONTROL_BUSY	Timed out while waiting to set the mutex on the control record. Another thread failed to release the mutex. Retry.
Includes:	genra.h

Description

The grtGetEvent( ) function checks if an event has occurred on any channel in the range of channels given. The function returns after the first event occurs and the other channels are not checked.

Example

#include "genra.h"  
GRT_EVENT event;  
int status, chan = 1;  
/* block for any event */  
while ((status = grtGetEvent(chan, chan, &event)) == GRT_NO_EVENT)  
       Sleep(1000L);

Click here to contact Dialogic Customer Engineering