Filter
Top Products
Dialogic
®
Global Call IP Technology Guide — November 2007 479
Dialogic Corporation
8.3.22 gc_ReqService( ) Variances for IP
This function is only supported in asynchronous mode.
The gc_ReqService( ) function can be used to register an endpoint with a registration server
(gateway in H.323 or registrar in SIP). Function parameters must be set as follows:
target_type
GCTGT_GCLIB_NETIF
target_ID
An IPT board device, obtained by using gc_OpenEx( ) with a devicename parameter of
“N_iptBx”
service_ID
Any valid reference to an unsigned long; must not be NULL
reqdatap
A pointer to a GC_PARM_BLK containing registration information.
respdatapp
Not used in asynchronous mode; set to NULL.
mode
EV_ASYNC
The registration information that can be included is protocol-specific as described in Table 38 and
Table 39, below.
To set the protocol type, the following parameter element is inserted into the GC_PARM_BLK
referenced by reqdatap:
IPSET_PROTOCOL
IPPARM_PROTOCOL_BITMASK
and one of the following parameter data values:
• IP_PROTOCOL_H323
• IP_PROTOCOL_SIP
• IP_PROTOCOL_H323 | IP_PROTOCOL_SIP
Note: The default value for the protocol, when not specified by the application, is IP_PROTOCOL_H323.
Registration options are specified by inserting the following parameter element into the
GC_PARM_BLK referenced by reqdatap:
IPSET_REG_INFO
IPPARM_OPERATION_REGISTER
and one of the following parameter data values:
• IP_REG_SET_INFO – override an existing registration value
• IP_REG_ADD_INFO – add a registration value
• IP_REG_DELETE_BY_VALUE – remove a specific registration value (i.e., local alias or
supported prefix only)
• IP_REG_QUERY_INFO – query a SIP Registrar for existing bindings (SIP only)
See Section 4.22.4, “Registration Code Examples”, on page 279 for more information.