4.4.1. UII Message (H.245)

Use the gc_Extension( ) function in synchronous mode with an ext_id (extension ID) of IPEXTID_SENDMSG to send UII messages. At the receiving end, a GCEV_EXTENSION event with the same ext_id value is generated. The metaevent associated with the GCEV_EXTENSION event will contain all of the data in the message.

The relevant parameter set IDs and parameter IDs for this purpose are:

• IPSET_MSG_H245
  • IPPARM_MSGTYPE - Set to IP_MSGTYPE_H245_INDICATION.
• IPSET_USERINPUTINDICATION
  • IPPARM_UII_ALPHANUMERIC

Notes:

1. The message type (IPPARM_MSGTYPE) is mandatory.
2. UII messages are only sent out to the IP network if the PrmDTMFXferMode parameter in the .config file is set to 1 (out-of-band DTMF transfer disabled). See Section 4.5, "Configuring DTMF Handling" for more information.
3. The gc_Extension( ) function must be called in synchronous mode, that is, the mode parameter must be set to EV_SYNC.

See Section 6.4, "IPSET_MSG_H245 Parameter Set" and Section 6.7, "IPSET_USERINPUTINDICATION Parameter Set" for more information.

The following code an example of how to send a UII message:

.
.
.
/* H245 UII Message - Note: Only works if PrmDtmfXferMode set to 1 in fcd file.*/

rc = gc_util_insert_parm_val(&t_PrmBlkp, IPSET_MSG_H245, IPPARM_MSGTYPE, 
     sizeof(int), IP_MSGTYPE_H245_INDICATION);
rc = gc_util_insert_parm_ref(&t_PrmBlkp, IPSET_USERINPUTINDICATION,
     IPPARM_UII_ALPHANUMERIC, 6 "12345");

if (rc == -1) {
    printf("Fail to insert parm");
    return -1;}
else
    printf("Sending IP H245 UII Message");

gc_Extension(GCTGT_GCLIB_CRN, crn, IPEXTID_SENDMSG, t_PrmBlkp, &t_RetBlkp,
             EV_SYNC);
gc_util_delete_parm(t_PrmBlkp);
.
.
. 

Click here to contact Telecom Support Resources