Dialogic IP Phone 05-2239-009 User Manual

130

Dialogic Corporation

   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);
   }

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. 

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