3.4.12. gc_OpenEx( )

The gc_OpenEx( ) function is supported in both asynchronous and synchronous mode. Using the function is 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 Global Call functions use the IPT board device, such as gc_SetConfigData( ) to specify call parameters (such as coders) for all devices in one operation or gc_ReqService( ) to perform registration and deregistration operations. See Section 3.4.17, gc_SetConfigData( ) and Section 3.4.14, gc_ReqService( ) 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 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.

In other technologies, an IPT board device can be used for alarms. However, for IP technology, the use of an IPT board device (iptBx) for alarms is not supported. When using Global Call with IP, alarms are reported on IP Media (ipm) devices, not IPT network (ipt) devices.

For Windows operating systems, the SRL function sr_getboardcnt( ) can be used to retrieve the number of IPT board devices in the system. The class_namep parameter in this context should be DEV_CLASS_IPT. The SRL function ATDV_SUBDEVS( ) can be used to retrieve the number of channels on a board. The dev parameter in this context should be an IPT board device handle, that is, a handle returned by gc_OpenEx( ) when opening an IPT board device.

For Linux operating systems, the SRL device mapper functions SRLGetAllPhysicalBoards( ), SRLGetVirtualBoardsOnPhysicalBoard( ) and SRLGetSubDevicesOnVirtualBoard( ) can be used to retrieve information about the boards and devices in the system.

Click here to contact Telecom Support Resources