Intel 05-1832-002 IP Phone User Manual


 
Voice API for Windows Operating Systems Library Reference — November 2003 237
retrieve feature support information for the device — dx_getfeaturelist( )
dx_getfeaturelist( )
retrieve feature support information for the device
!
!!
! Description
The dx_getfeaturelist( ) function returns information about the features supported on the device.
This information is contained in the FEATURE_TABLE data structure.
!
!!
! Cautions
This function fails if an invalid device handle is specified.
On DM3 analog boards, use dx_getctinfo( ) to return information about the type of front end
or network interface on the board. The network interface information is contained in the
ct_nettype field of CT_DEVINFO.
Name: int dx_getfeaturelist(dev, feature_tablep)
Inputs: int dev
valid board or channel device handle
FEATURE_TABLE *feature_tablep
pointer to features information structure
Returns: 0 on success
-1 on error
Includes: srllib.h
dxxxlib.h
Category: Configuration
Mode: synchronous
Platform: DM3, Springware
Parameter Description
dev specifies the valid device handle obtained when a board (in the format
dxxxBn) or channel (dxxxBnCm) was opened using dx_open( ).
Note: Specifying a board device handle is not supported on Springware
boards.
Note: On high-density DM3 boards, retrieving information for a channel
device can be time-consuming as each channel is opened one by one. You
can retrieve information for the board device instead. All channel devices
belonging to the specific board device have the same features as the parent
board.
feature_tablep specifies a pointer to the FEATURE_TABLE data structure which contains the
bitmasks of various features supported such as data format for play/record, fax
features, and more. For more information on this structure, see
FEATURE_TABLE, on page 525.