Dialogic 05-2239-009 User Manual

Page of 604
255
Dialogic Corporation
Retrieving TSMs from Alerting, Connected, Proceeding, 
ReleaseComplete, and Setup Messages
To retrieve TSM after receiving a Global Call state change event corresponding to an Alerting, 
Connected, Proceeding, ReleaseComplete, or Setup message, the application first constructs a 
GC_PARM_BLK that specifies the type of information it wishes to retrieve, then calls the 
gc_Extension( ) function to request the information. 
The GC_PARM_BLK must contain the following two parameter elements:
IPSET_TUNNELEDSIGNALMSG
IPPARM_TUNNELEDSIGNALMSG_CONTENT
value is unused; set to 1
IPSET_TUNNELEDSIGNALMSG
IPPARM_TSM_CONTENT_EVENT
value = appropriate TSM_CONTENT_... tag value as listed in Table 17
When the application calls gc_Extension( ), the parameters should be set up as follows:
target_type must be GCTGT_GCLIB_CRN
target_id must be a valid CRN
ext_id must be IPEXTID_GETINFO
parmblkp must point to the GC_PARM_BLK that was configured to contain the required 
parameter element as just described. 
retblkp must be a valid pointer to a GC_PARM_BLK 
mode must be EV_ASYNC
If the received H.225 message contained a tunneled signaling message, the library generates an 
asynchronous GCEV_EXTENSIONCMPLT completion event. The extevtdatap field in the 
METAEVENT structure for this event is a pointer to an EXTENSIONEVTBLK structure, which in 
turn contains a GC_PARM_BLK that contains the fields of the received tunneled signaling 
Table 17. H.225 Messages and Global Call Events for Receiving Tunneled Signaling 
Messages
H.225 message
Global Call event used 
to notify application
Tag used to retrieve message fields 
via GCEV_EXTENSIONCMPLT
Setup
GCEV_OFFERED
TSM_CONTENT_OFFERED
Proceeding
GCEV_PROCEEDING †
TSM_CONTENT_PROCEEDING
Alerting
GCEV_ALERTING
TSM_CONTENT_ALERTING
Connected
GCEV_CONNECTED
TSM_CONTENT_CONNECTED
Release Complete
GCEV_DISCONNECTED
TSM_CONTENT_DISCONNECTED
Facility
GCEV_EXTENSION
TSM_CONTENT_EXTENSION
† The GCEV_PROCEEDING event is maskable. When Tunneled Signalling Messages are enabled, the 
application must ensure that this event is not masked.