grtInit( )

Description | Example

Name:	int grtInit (int start_chan, int end_chan, int attributes)
Inputs:	int start_chan	Integer representing the first channel to control.
	int end_chan	Integer representing the last channel to control.
	int attribute	Attributes associated with the given channel range. The attributes include programming model, event notification and response.
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_ALREADY_CONTROLLED	If any channel in the range is controlled by another thread.
	GRT_CONTROL_BUSY	Semaphore could not be locked.
	GRT_UNLOCK_FAIL	Semaphore could not be unlocked.
	GRT_LOCK_FAILED	Semaphore could not be locked.
	GRT_PROCESS_ATTRIBUTE_FAIL	Could not enable notification or response on the fax channel.
	GRT_OPEN_FAIL	Could not open notification or response pipe to fax channel.
Includes:	genra.h

Description

The grtInit( ) function initializes the GRT interface. To initialize internal data structure with the proper value to control the given range of channels.

This function can be called multiple times in a thread as long as different ranges of channels are used.

These are the attributes that are currently supported.

• GRT_CALL_TERM_ENABLE
• GRT_INFO_EXCHANGE_ENABLE
• GRT_RECV_DIS_ENABLE
• GRT_RECV_DCS_ENABLE
• GRT_PAGE_BREAK_ENABLE
• GRT_DIAL_ENABLE
• GRT_CALL_PENDING_ENABLE
• GRT_CALL_TERM_RESPONSE_ENABLE
• GRT_INFO_EXCHANGE_RESPONSE_ENABLE
• GRT_CALL_PENDING_RESPONSE_ENABLE

Behavior

grtInit( ) has been enhanced to prevent automatic posting of the completed queue record to the queue file. This action is usually not necessary as most applications also receive a copy of the same queue record when the GRT_CALL_TERM_ENABLE attribute is specified in grtInit( ).

However, you can restore the ability of the GDK to automatically post the completed queue record to the queue file with the following gfdRemoteRequest( ) command as demonstrated in the code fragment:

#include <genra.h>  
	...  
int grtAttributes = GRT_CALL_TERM_ENABLE;  
int chan = 1, status, rresult;  
	...  
status = grtInit( chan, chan, grtAttributes );  
if ( GRT_SUCCESS == status )  
{  
   // allow posting of results to queue file  
   status = gfdRemoteRequest(  
1,   
chan,   
GFXRTACTION,   
GFXRTBP_CALLTERM,   
GFXRT_CONTINUE,   
NULL,   
0,   
&rresult  
);  
   if ( 0 == status ) {  
      printf( "Success: Posting enabled!\n" );  
   }  
}  
	...

The gfdRemoteRequest command must be issued on a per-channel basis.

Example

#include "genra.h"  
int status, chan = 1;  
/* initialize GRT pipes interface for fax    

channel 1 */  
status = grtInit(chan,chan,GRT_CALL_TERM_ENABLE);  
if (status != GRT_SUCCESS)  
{  
    fprintf(stderr, "[%2d] grtInit failed\n", chan);  
    myErrorRoutine(status);  
}

Click here to contact Dialogic Customer Engineering