grtStop( )

Description | Example

Name:	int grtStop (int start_chan, int end_chan)
Inputs:	int start_chan	Starting channel in range of channels.
	int end_chan	Ending channel in range of channels.
Outputs:	None
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_ANOTHER_THREAD	Another thread controls a channel in the range given.
	GRT_CONTROL_BUSY	The semaphore could not be locked.
	GRT_UNLOCK_FAIL	The semaphore could not be unlocked.
	GRT_LOCK_FAILED	The semaphore could not be locked.
	GRT_PROCESS_ATTRIBUTE_ FAIL	Could not enable notification or response on the fax channel.
	GRT_CLOSE_FAIL	Could not close notification or response pipe to fax channel.
Includes:	genra.h

Description

The grtStop( ) function stops the GRT API from managing the fax channels. This function stops control of the given range of channels by the current thread of execution. Allowing starting and stopping of the GRT allows a thread to add or delete channels that it controls dynamically.

Example

#include "genra.h"  
int status, chan = 1;  
if (status = grtStop(chan, chan))  
{  
   fprintf(stderr, "[%2d] grtStop failed\n",  chan);  
   myErrorRoutine(status);  
}

Click here to contact Dialogic Customer Engineering