Global Call API for HMP on Windows Programming Guide — August 2006 23
Product Description
Figure 3. Call Control Library States
Table1 describes the different states of a call control library.
Each configured call control library is assigned an ID number by Global Call. Each library also has
a name in an ASCII string format. Library functions perform tasks such as converting a call control
library ID to an ASCII name and vice-versa, determining the configured libraries, determining the
available libraries, determining the libraries started and the libraries that failed to start, and other
library functions.
The following functions are the call control library information functions. All the library functions
are synchronous, thus they return without a termination event.
•gc_CCLibIDToName( )
•gc_CCLibNameToID( )
•gc_CCLibStatusEx( )
•gc_GetVer()
See the Global Call API Library Reference for detailed information about these functions.
1.5 Global Call Object Identifiers
The Global Call API is call-oriented, that is, each call initiated by the application or network is
assigned a Call Reference Number (CRN) for call control and tracking purposes. Call handling is
independent of the line device over which the call is routed. Each line device or device group is
assigned a Line Device Identifier (LDID) that enables the application to address any resource or
gc_Start()
Start
Failed
Start
Successful
CONFIGURED
AVAILABLE FAILED
Table1. Call Control Library States
State Description
Configured A library that is supported by Global Call is considered a configured library.
Available A library that has been successfully started is considered to be available for use by a
Global Call application.
Failed A library that has failed to start is considered to be unavailable for use by a Global Call
application.