Dialogic Dialogic Global Call IP IP Phone User Manual


 
130 Dialogic
®
Global Call IP Technology Guide — November 2007
Dialogic Corporation
IP-Specific Operations
if (choiceOfNSData) /* App decides the CHOICE of OBJECTIDENTIFIER.
It cannot set both objid & H221 */
{
gc_util_insert_parm_ref(&pParmBlock,
IPSET_NONSTANDARDDATA,
IPPARM_H221NONSTANDARD,
(unsigned char)sizeof(IP_H221NONSTANDARD),
&appH221NonStd);
}
else
{
gc_util_insert_parm_ref(&pParmBlock,
IPSET_NONSTANDARDDATA,
IPPARM_NONSTANDARDDATA_OBJID,
(unsigned char)(strlen(pOid)+1),
pOid);
}
4.3.4 Specifying Nonstandard Control Information (H.323)
To specify Nonstandard Control information to be included in the H.323 SETUP message, use the
gc_SetUserInfo( ) function with a duration parameter of GC_SINGLECALL to preset the
information. If the duration parameter is set to GC_ALLCALLS, the function fails.
To specify Nonstandard Control data, the GC_PARM_BLK pointed by the infoparmblkp function
must be set up with two parameter elements that use the IPSET_NONSTANDARDCONTROL
parameter set ID. The first required parameter element specifies the Nonstandard Control data
itself, and the second parameter element identifies the type of object identifier to use.
The maximum length of the Global Call parameter used for the Nonstandard Control information is
configured at start-up via the max_parm_data_size field in the IPCCLIB_START_DATA structure.
The default size is 255 (for backwards compatibility), but applications may configure it to be as
large as 4096 bytes. Applications must use the extended gc_util_..._ex( ) functions to insert or
extract any GC_PARM_BLK parameter elements whose data length is defined to be greater than
255.
Note: In practice, applications may not be able to utilize the full maximum length of the nonstandard
control parameter element as configured in max_parm_data_size. The H.323 stack limits the
overall size of messages to be max_parm_data_size + 512 bytes, and any messages that exceed this
limit are truncated without any notification to the application.
The parameter element for the Nonstandard Control data is:
IPSET_NONSTANDARDCONTROL
IPPARM_NONSTANDARDDATA_DATA
value = Nonstandard Data string, max length =
IPCCLIB_START_DATA.max_parm_data_size (configurable at library start-up)
The parameter element for the Nonstandard Control identifier is one (and only one) of the
following:
IPSET_NONSTANDARDCONTROL
IPPARM_NONSTANDARDDATA_OBJID
value = array of unsigned integers, max length = MAX_NS_PARM_OBJID_LENGTH