Intel 05-1832-002 User Manual

16

Before you can call any other library function on a device, that device must be opened using a 
device management function. The 

 function returns a unique voice device handle. This 

handle is the only way the device can be identified once it has been opened. The 

function closes a device via its handle. 

A set of device management functions exists for each Intel® Dialogic® library, such as fax (fx_ 
functions), modular station interface (ms_ functions), and conferencing (dcb_ functions). See the 
appropriate API Library Reference for more information on these functions.

Device management functions do not cause a device to be busy. In addition, these functions will 
work on a device whether the device is busy or idle.

For more information about opening and using voice devices, particularly on DM3 boards, see the 
Voice API Programming Guide. Also see this guide for more information about naming 
conventions for board and channel devices.

Use Standard Runtime Library device mapper functions to return information about the structure of 
the system, such as a list of all physical boards, a list of all virtual boards on a physical board, and 
a list of all subdevices on a virtual board. This device information is used as input to device 
management functions. For more information on device mapper functions, see the Standard 
Runtime Library API Library Reference.

The device management functions are:

 

closes a board or channel device handle

 

opens a board or channel device handle

Configuration functions allow you to alter, examine, and control the physical configuration of an 
open device. In general, configuration functions operate on an idle device. Configuration functions 
cause a device to be busy and return the device to an idle state when the configuration is complete. 
See the Voice API Programming Guide for information about busy and idle states. 

The configuration functions are:

clears all digits in the firmware digit buffer

returns the voice dynamic link library (DLL) version number

returns information about the features supported on the device

gets the current parameter settings for an open device