3.4.17. gc_SetConfigData( )

The gc_SetConfigData( ) function is used for a number of different purposes:

• Setting parameters for all devices on a board, including devices that are already open
• Enabling and disabling unsolicited GCEV_EXTENSION events on a board device basis
• Setting the type of DTMF support and the RFC 2833 payload type on a board device basis
• Masking call state events on a line device basis

Notes:

1. The gc_SetConfigData( ) operates on a board device, that is, a device opened using gc_OpenEx( ) with :N_iptBx:P_IP in the devicename parameter. By its nature, a board device is multi-protocol, that is, it applies to both the H.323 and SIP protocols and is not directed to one specific protocol. You can not open a board device (with :P_H323 or :P_SIP in the devicename parameter) to target a specific protocol.
2. When using the gc_SetConfigData( ) function to set parameters, the parameter values apply to all board devices, including devices that are already open. The parameters can be overridden by specifying new values in the gc_SetUserInfo( ) function (on a per line device basis) or the gc_MakeCall( ) function (on a per call basis).
3. Coder information can be specified for a device when using gc_SetConfigData( ), or when using gc_MakeCall( ) to make a call, or when using gc_AnswerCall( ) to answer a call.

When using the gc_SetConfigData( ) function on a board device (the first three bullets above), use the following function parameter values:

• target_type - GCTGT_CCLIB_NETIF
• target_id - An IPT board device that can be obtained by using the gc_OpenEx( ) function with :N_iptBx:P_IP in the devicename parameter. See Section 3.4.12, gc_OpenEx( ) for more information.
• target_datap - A pointer to a GC_PARM_BLKP structure that contains the parameters to be configured. The parameters that can be included in the GC_PARM_BLK are all the parameters in Table 2, Configurable Call Parameters. In additon, Table 4 shows additional parameters that are only configurable using gc_SetConfigData( ).

Table 4. Parameters Configurable Using gc_SetConfigData( )

Set ID	Parameter IDs	Use Before †	H.323/ SIP
GCSET_CALL_CONFIG	GCPARM_CALLPROC †† Datatype: Enumeration with one of the following values: GCCONTROL_APP - The application must use gc_CallAck( ) to send the Proceeding message. This is the default. GCCONTROL_TCCL - The stack sends the Proceeding message automatically.	gc_AnswerCall( )	H.323 and SIP
IPSET_CALLINFO	IPPARM_H245TUNNELING ††† Datatype: Enumeration with one of the following values: IP_H245TUNNELINGON IP_H245TUNNELINGOFF	gc_AnswerCall( )	H.323 only
IPSET_DTMF	IPPARM_SUPPORT_DTMF_BITMASK Datatype: Uint8[ ] IPPARM_DTMF_RFC2833_ PAYLOAD_TYPE Datatype: Uint8[ ]	gc_AnswerCall( ) gc_MakeCall( )	H.323 and SIP
IPSET_VENDORINFO	IPPARM_VENDOR_PRODUCT_ID Datatype: String, max. length = MAX_PRODUCT_ID_LENGTH (32). IPPARM_VENDOR_VERSION_ID Datatype: String, max. length = MAX_VERSION_ID_LENGTH (32). IPPARM_H221NONSTD Datatype: IP_H221NONSTANDARD.	gc_AnswerCall( ) gc_MakeCall( )	H.323 only
IPSET_ EXTENSIONEVT_MSK	GCACT_ADDMSK Datatype: Uint8[ ] GCACT_SETMSK Datatype: Uint8[ ] GCACT_SUBMSK Datatype: Uint8[ ]	gc_AnswerCall( )	H.323 and SIP
† Information can be set in any state but it is only used in certain states. See Section 6, IP-Specific Parameter Set Reference for more information. †† This is a system configuration parameter for the terminating side, not a call configuration parameter. It cannot be overwritten by setting a new value in gc_SetUserInfo( ) or gc_MakeCall( ). ††† Applies to the configuration of tunneling for inbound calls only. See Section 4.16, Enabling and Disabling Tunneling in H.323 for more information.

As in other technologies supported by Global Call, the gc_SetConfigData( ) function can be used to mask call state events, such as GCEV_ALERTING, on a line device basis. When used for this purpose, the target_type is GCTGT_GCLIB_CHAN and the target_ID is a line device. See the Call State Event Configuration section in the Global Call API Programming Guide for more information on masking events in general.

Click here to contact Telecom Support Resources