Dialogic 05-2239-009 User Manual

476

Dialogic Corporation

The gc_OpenEx( ) function is supported in both synchronous and asynchronous mode, but the use 
of asynchronous mode is recommended. 

The procedure for opening devices is the same regardless of whether H.323 or SIP is used. The IPT 
network device (N_ipt_BxTy) and IP Media device (M_ipmBxCy) can be opened in the same 
gc_OpenEx( ) call and a voice device (V_dxxxBwCz) can also be included. 

The format of the devicename parameter is:

:P_nnnn:N_iptBxTy:M_ipmBxCy:V_dxxxBwCz

 

Notes: 1. The board and timeslot numbers for network devices do not have to be the same as the board and 

channel numbers for media devices. 

2. It is possible to specify :N_iptBx (without any :M component) in the devicename parameter to 

get an IPT board device handle. Certain Dialogic

®

 Global Call API functions, such as 

gc_SetConfigData( ), use the IPT board device to specify call parameters (such as coders) for all 
devices in one operation or gc_ReqService( ) to perform registration and deregistration 
operations. See 

, on page 479 for more information. 

3. It is also possible to specify :M_ipmBx (without any :N component) in the devicename 

parameter to get an IP Media board device handle.

The prefixes (P_, N_, M_ and V_) are used for parsing purposes. These fields may appear in any 
order. The conventions described below allow the Dialogic

®

 Global Call API to map subsequent 

calls made on specific line devices or CRNs to interface-specific libraries. The fields within the 
devicename parameter must each begin with a colon. 

The meaning of each field in the devicename parameter is as follows:

P_nnnn 

Specifies the IP protocol to be used by the device. This field is mandatory. Possible values are: 

P_H323 – Use the device for H.323 calls only 

P_SIP – Use the device for SIP calls only 

P_IP – Multi-protocol option; use the device for SIP or H.323 calls

Note: When specifying an IPT board device (see below), use the multi-protocol option, 

P_IP. 

N_iptBxTy 

Specifies the name of the IPT network device where x is the logical board number and y is the 
logical channel number. An IPT board device can be specified using N_iptBx, where x is the 
logical board number. 

M_ipmBxCy 

Specifies the name of the IP Media device, where x is the logical board number and y is the 
logical channel number to be associated with an IPT network device. This field is optional. 

V_dxxxBwCz 

Specifies a voice resource, where w and z are the voice board and channel numbers 
respectively. This field is optional.