Dialogic® Global Call API Library Reference

gc_GetCallState( ) — retrieve the state of the call
returned is technology specific, see the technology-specific error header file(s) for the error
definition (for example, ccerr.h or isdnerr.h file for the ISDN call control library).
Example
#include
#include
#include
#include
#define MAXCHAN 30 /* max. number of channels in system */
/*
* Data structure which stores all information for each line
*/
struct linebag {
LINEDEV ldev; /* GlobalCall line device handle */
CRN crn; /* GlobalCall API call handle */
int state; /* state of first layer state machine */
} port[MAXCHAN+1];
struct linebag *pline; /* pointer to access line device */
int get_call_state(int port_num)
{
LINEDEV ldev; /* line device ID */
CRN crn; /* call reference number */
int call_state; /* current state of call */
GC_INFO gc_error_info; /* GlobalCall error information data */
/* Find info for this time slot, specified by 'port_num' */
/* (Assumes port_num is valid) */
pline = port + port_num;
crn = pline -> crn;
/*
* Retrieve the call state and save it.
*/
if (crn)
{
if (gc_CRN2LineDev( crn, &ldev) != GC_SUCCESS)
{
/* get and process error */
gc_ErrorInfo( &gc_error_info );
printf ("Error: gc_CRN2LineDev() on crn: 0x%lx, GC ErrorValue: 0x%hx - %s,
CCLibID: %i - %s, CC ErrorValue: 0x%lx - %s\n",
crn, gc_error_info.gcValue, gc_error_info.gcMsg,
gc_error_info.ccLibId, gc_error_info.ccLibName,
gc_error_info.ccValue, gc_error_info.ccMsg);
return (gc_error_info.gcValue);
}
if (gc_GetCallState( crn, &call_state) != GC_SUCCESS)
{
/* process error return as shown */
gc_ErrorInfo( &gc_error_info );
printf ("Error: gc_GetCallState() on devive handle: 0x%lx,
GC ErrorValue: 0x%hx - %s, CCLibID: %i - %s, CC ErrorValue: 0x%lx - %s\n",
ldev, gc_error_info.gcValue, gc_error_info.gcMsg,
gc_error_info.ccLibId, gc_error_info.ccLibName,
gc_error_info.ccValue, gc_error_info.ccMsg);
return (gc_error_info.gcValue);
}
}
}
pline->state = call_state;
return (0);
138 Dialogic ® Global Call API Library Reference — January 2008
Dialogic Corporation