Global Call API for HMP on Windows Programming Guide — August 2006 123
Real Time Configuration Management
9.7.4 Setting Line Device Configuration in Asynchronous Mode
Note: This section applies to E1, T1 and ISDN technologies only.
The Global Call RTCM allows the customer application to retrieve or change the default
configuration of a line device in asynchronous mode.
Asynchronous mode is generally suggested to be used in either of the following cases:
•The request is to update parameters that are call related and the channel is not at the NULL
state
•The target type is GCTGT_FIRMWARE_CHAN or GCTGT_FIRMWARE_NETIF (that is,
the parameters are maintained in firmware).
Figure 30 shows the procedure for setting line device configuration in asynchronous mode.
Figure 30. Setting Line Device Configuration in Asynchronous Mode (E1, T1 and ISDN
Techno logy)
The procedure for setting the configuration of a Line Device in asynchronous mode is as follows:
1. The channel has an active call. Create the target object data (that is, a GC_PARM_BLK data
structure) with the appropriate set ID, parm ID, value size, and value buffer by calling the
Global Call utility functions. See the Global Call API Library Reference for more information.
2. Call the gc_SetConfigData( ) function with:
target_type = GCTGT_CCLIB_NETIF, GCTGT_PROTOCOL_NETIF,
GCTGT_FIRMWARE_NETIF, GCTGT_CCLIB_CHAN, GCTGT_PROTCOL_CHAN, or
Application GlobalCall
Library
GCEV_CONNECTED or
GCEV_ANSWERED
Create Target Data for Parameters
of the Line Device
Set the Parameters if this Timeslot
Target Object in Asynchronous Mode
Force the Line to the NULL State
gc_util_insert_parm_ref () or
gc_util_insert_parm_val ()
gc_SetConfigData ()
Received RESETLINEDEV Event
gc_ResetLineDev ()
Received SETCONFIGDATA Event
GCEV_RESETLINEDEV
GCEV_SETCONFIGDATA
Received Connected or
Answered Event