Dialogic Dialogic Global Call IP IP Phone User Manual


 
256
Dialogic Corporation
message. Applications are then able to extract the data of interest using the gc_util_..._ex( )
functions.
The GC_PARM_BLK will always contain the following three parameter elements:
IPSET_TUNNELEDSIGNALMSG
IPPARM_TSM_CONTENT_EVENT
value = the appropriate TSM_CONTENT_... tag value
one or the other of the following two elements:
IPSET_TUNNELEDSIGNALMSG
IPPARM_TUNNELEDSIGNALMSG_PROTOCOL_OBJECTID
value = IP_TUNNELPROTOCOL_OBJECTID data structure
IPSET_TUNNELEDSIGNALMSG
IPPARM_TUNNELEDSIGNALMSG_ALTERNATEID
value = IP_TUNNELPROTOCOL_ALTID data structure
and the following element:
IPSET_TUNNELEDSIGNALMSG
IPPARM_TUNNELEDSIGNALMSG_CONTENT
value = tunneled signaling message content string
If the TSM includes optional nonstandard data, there will be two additional parameter elements:
IPSET_TUNNELEDSIGNALMSG
IPPARM_TUNNELEDSIGNALMSG_NSDATA_DATA
value = nonstandard data string
and one of the following two elements:
IPSET_TUNNELEDSIGNALMSG
IPPARM_TUNNELEDSIGNALMSG_NSDATA_OBJID
value = nonstandard data object ID string in ASN.1 format
IPSET_TUNNELEDSIGNALMSG
IPPARM_TUNNELEDSIGNALMSG_NSDATA_H221NS
value = IP_H221NONSTANDARD data structure
Notes: 1. The application must take care to retrieve the Annex M Message information from any incoming
H.225 message before the next H.225 message arrives. If the new message also contains TSM
information, that new TSM overwrites the prior information.
2. The overall message size that the Global Call H.323 stack can handle is defined as
max_parm_data_size (which is configured at library startup) + 512 bytes. Any message that is
received which exceeds this length is truncated.
3. Parameter values that are contained in a GC_PARM_BLK are subject to maximum length limits
that are defined for each parameter type. Any data received in a TSM that exceeds these defined
limits is truncated without notification to the application.
4. The application should use the extended gc_util_..._ex( ) functions when extracting parameters
from a GC_PARM_BLK that contains TSM contents because some of the Global Call
parameters for TSMs support data length that may exceed 255 bytes.