Filter
Top Products
488 Dialogic
®
Global Call IP Technology Guide — November 2007
Dialogic Corporation
• set SIP message information fields
• set IP Media Library parameters (for example, echo cancellation parameters) for a specified
line device
• associate and disassociate a T.38 Fax device with a Media device
The gc_SetUserInfo( ) function is used 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 Dialogic
®
Global Call API function that initiates the transmission of
information on the line, such as, gc_AnswerCall( ), gc_AcceptCall( ), or gc_CallAck( ).
The parameters that are configurable using gc_SetUserInfo( ) are given in Table 34, “Configurable
Call Parameters When Using H.323”, on page 461 and Table 35, “Configurable Call Parameters
When Using SIP”, on page 464. In addition, the DTMF support bitmask, (see Table 40 and
Table 41) is also configurable using gc_SetUserInfo( ).
Note: The gc_SetUserInfo( ) function may not be used to set the IP protocol for a multi-protocol line
device (i.e., one that was opened in P_IP mode). The only mechanism for selecting the protocol to
use is the GC_MAKECALL_BLK structure associated with the gc_MakeCall( ) function.
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 (:P_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 (:P_H323 or :P_SIP), then the
information in the function automatically applies to that protocol only and is used by calls
made using that protocol.
Note: Use gc_SetConfigData( ) to set parameters on board devices.
In the SIP third party call control (3PCC) operating mode, gc_SetUserInfo( ) is used to set SDP
content that will be sent in outbound SIP messages when the function that sends the message does
not take a parameter block as one of its parameters. To support this specific use of
gc_SetUserInfo( ) an additional duration parameter value, GC_NEXT_OUTBOUND_MSG, has
been defined for the function.
gc_SetUserInfo( ) is also used to set Information Elements (IEs) in Q.931 messages. See
Section 4.8.3, “Setting Q.931 Message IEs”, on page 170 for more information.
8.3.26.1 Setting Call Parameters for the Next Call
The relevant 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)