Dialogic Global Call IP Manual Do Utilizador

451

Dialogic Corporation

The gc_Extension( ) function is only used in the context of a call where the protocol is already 
known, therefore the protocol does not need to be specified. When protocol-specific information is 
specified and it is not of the correct protocol type, for example, attempting to send a Q.931 
FACILITY message in a SIP call, the operation fails. 

, on page 145 for a code 

example showing how to identify the type of extension event and extract the related information. 

The gc_GetAlarmParm( ) function can be used to get QoS threshold values. The function 
parameter values in this context are: 

linedev 

The media device handle, retrieved using the gc_GetResourceH( ) function. See 

, on page 264 for more information.

aso_id 

The alarm source object ID. Set to ALARM_SOURCE_ID_NETWORK_ID. 

ParmSetID 

Must be set to ParmSetID_qosthreshold_alarm. 

alarm_parm_list 

A pointer to an ALARM_PARM_FIELD structure. The alarm_parm_number field is not used. 
The alarm_parm_data field is of type GC_PARM, which is a union. In this context, the type 
used is void *pstruct, and is cast as a pointer to an IPM_QOS_THRESHOLD_INFO structure, 
which includes an IPM_QOS_THRESHOLD_DATA structure that contains the parameters 
representing threshold values. See the IPM_QOS_THRESHOLD_INFO structure in the 

IPEXTID_SEND_DTMF

Used to send DTMF digits. When this call is successful, the sending side 
receives a GCEV_EXTENSIONCMPLT event with the same ext_id. The 
remote side receives a GCEV_EXTENSION event with 
IPEXTID_RECEIVE_DTMF but only when configured for notification of a 
specific type of DTMF. See 

, on page 154 for more information.

This extension ID is not supported in 3PCC operating mode.

IPEXTID_SENDMSG

Used to send SIP, H.245, Q.931, and RAS messages. When using this 
Extension ID, the first parameter inserted into the GC_PARM_BLK must 
be from one of the following parameter sets: 

• IPSET_MSG_H245 

• IPSET_MSG_Q931 

• IPSET_MSG_REGISTRATION

• IPSET_MSG_SIP

• IPSET_PROTOCOL 

When the gc_Extension( ) function completes successfully, the sending 
side receives a GCEV_EXTENSIONCMPLT event with the same ext_id. 
The remote side receives a GCEV_EXTENSION event with an ext_id 
field value of IPEXTID_RECEIVEMSG.