Dialogic Global Call IP Benutzerhandbuch

344

Dialogic Corporation

CCLIB_START_STRUCT and GC_START_STRUCT structures, contains a 
media_operational_mode field that determines the Dialogic

®

 Global Call API library mode of 

operation. The default value of this field that is set by the 

initialization function specifies the first party call control (1PCC) mode; applications wishing to 
use the 3PCC mode must set the media_operational_mode field to the value 
MEDIA_OPERATIONAL_MODE_3PCC before calling gc_Start( ). 

The following code snippet shows how an application initializes the CCLIB_START_STRUCT 
structure and sets the parameter for 3PCC operating mode.

#include "gclib.h"
..
..
#define BOARDS_NUM 1
..
..
/* initialize start parameters */
IPCCLIB_START_DATA cclibStartData;
memset(&cclibStartData,0,sizeof(IPCCLIB_START_DATA));
IP_VIRTBOARD virtBoards[BOARDS_NUM];
memset(virtBoards,0,sizeof(IP_VIRTBOARD)*BOARDS_NUM);

/* initialize start data structure */
INIT_IPCCLIB_START_DATA(&cclibStartData, BOARDS_NUM, virtBoards);

/* initialize virtual board structure */
INIT_IP_VIRTBOARD(&virtBoards[0]);

// set 3PCC operating mode
cclibStartData.media_operational_mode = MEDIA_OPERATIONAL_MODE_3PCC;

In order to change the operating mode when the Dialogic

®

 Global Call API library is running, the 

library must first be stopped by calling the gc_Stop( ) function. The IP CCLIB does not support the 
invocation of any library operations after performing a gc_Stop( ). This function drops all calls, 
stops the Dialogic

®

 Global Call API library, and releases all resources so that the library can be 

restarted in a different mode. However, the application is responsible for terminating all processes 
after calling gc_Stop( ). The application must then be restarted and gc_Start( ) invoked to change 
the library and virtual board startup parameters. 

Refer to 

, on page 491, for more information about initializing the Dialogic

®

 

Global Call API library.

Several Dialogic

®

 Global Call API changes have been made to support 3PCC mode. Third party 

call control-specific changes are as follows: