grtRespond( )

Description | Example

Name:	int grtRespond (GRT_EVENT *event, GRT_RESPONSE *response)
Inputs:	GRT_EVENT *event	Pointer to an event structure.
	GRT_RESPONSE *response	Pointer to a response structure.
Outputs:	None
Returns:	GRT_SUCCESS	Successful.
	GRT_ANOTHER_THREAD	Channel is controlled by another thread.
	GRT_INVALID_RESPONSE	Type of response to be sent is invalid.
	GRT_RESPONSE_FAIL	Send of response message failed.
	GRT_INVALID_CHAN	Channel that event occurred upon is not the same channel the response is being sent to.
	GRT_CONTROL_BUSY	The semaphore could not be set.
	GRT_UNLOCK_FAIL	The semaphore could not be released.
	GRT_LOCK_FAILED	The semaphore could not be set.
	GRT_NOT_INIT	The specified channel has not been grtInit'ed.
	GFD_BROKEN_PIPE	The response pipe is broken.
	GFD_INVALID_HANDLE	The response pipe is corrupted.
Includes:	genra.h

Description

The grtRespond( ) function responds to an event.

This function responds to the given event. The response structure must have the response_type (GRT_CONTINUE, GRT_END_CALL, etc.) initialized before this function is called.

Example

#include "genra.h"  
GRT_EVENT event;  
GRT_RESPONSE response;  
int status, chan = 1;  
int grtAttributes = GRT_CALL_TERM_ENABLE |  
GRT_CALL_TERM_RESPONSE_ENABLE;  
/* initialize GRT pipes interface for fax channel 1 */  
status = grtInit(chan, chan, grtAttributes);  
if (status != GRT_SUCCESS)  
{  
   fprintf(stderr, "[%2d] grtInit failed, %d\n", chan, status);  
   return -1;  
}  
/* submit queue record */  
...  
/* block for any event */  
while ((status = grtGetEvent(chan, chan, &event))     

== GRT_NO_EVENT)  
      Sleep(1000L);  
if (event.event_type == GRT_CALL_TERM)  
{  
    /* fill in response structure */  
    response.response_type = GRT_END_CALL;  
    /* respond to event (do not post queue record to file) */  
    if (status = grtRespond(&event, &response))  
    {  
       printf("[%2d] grtRespond error %d\n", event.chan, status);  
       return -1;  
    }  
}

Click here to contact Dialogic Customer Engineering