3.4.18. gc_SetUserInfo( )

The gc_SetUserInfo( ) function can be used to:

• Set call values for the duration of a single call
• Set call values for all calls on the specified line device

The gc_SetUserInfo( ) function is used only to set the values of call-related information, such as coder information, display information, phone list etc. before a call has been initiated. The information is not transmitted until the next Global Call function, such as, gc_AnswerCall( ), gc_AcceptCall( ), gc_CallAck( ) etc. that initiates the transmission of information on the line.

Note: If no receive coder type is specified, any supported coder type is accepted.

The parameters that are configurable using gc_SetUserInfo( ) are given in Table 2, Configurable Call Parameters. In addition, the DTMF support bitmask, see Table 4, Parameters Configurable Using gc_SetConfigData( ), is also configurable using gc_SetUserInfo( ).

The gc_SetUserInfo( ) function operates on either a CRN or a line device:

• If the target of the function is a CRN, the information in the function is automatically directed to the protocol associated with that CRN.
• If the target of the function is a line device, then:
  • If the line device was opened as a multi-protocol device (:N_PIP), the information in the function is automatically directed to each protocol and is used by either H.323 or SIP calls made subsequently.
  • If the line device was opened as a single-protocol device (:N_H323 or :N_SIP), then the information in the function automatically applies to that protocol only and is used by calls made using that protocol.

Setting Call Parameters for the Next Call

The pertinent function parameter values in this context are:

• target_type - GCTGT_GCLIB_CRN (if a CRN exists) or GCTGT_GCLIB_CHAN (if a CRN does not exist)
• target_id - CRN (if it exists) or line device (if a CRN does not exist)
• duration - GC_SINGLECALL
• infoparmblkp - a pointer to a GC_PARM_BLK with a list of parameters (including coder information) to be set for the line device.

Note: If a call is in the Null state, the new parameter values apply to the next call. If a call is in a non-Null state, the new parameter values apply to the remainder of the current call only.

Setting Call Parameters for the Next and Subsequent Calls

When the duration parameter is set to GC_ALLCALLS, the new call values become the default values for the line device and are used for all subsequent calls on that device. The pertinent function parameter values in this context are:

• target_type - GCTGT_GCLIB_CHAN
• target_id - line device
• duration - GC_ALLCALLS
• infoparmblkp - a pointer to a GC_PARM_BLK with a list of parameters (including coder information) to be set for the line device.

Note: If a call is in the Null state, the new parameter values apply to the next call and all subsequent calls. If a call is in a non-Null state, the new parameter values apply to the remainder of the current call and all subsequent calls.

Click here to contact Telecom Support Resources