Intel 05-1832-002 User Manual

Page of 564
Voice API for Windows Operating Systems Library Reference — November 2003
221
get information about a voice device — dx_getctinfo( )
dx_getctinfo( )
get information about a voice device
!
!
!
Description
The dx_getctinfo( ) function returns information about a voice channel of a voice device. This 
information is contained in a 
 structure. 
!
!
!
Cautions
This function will fail if an invalid voice channel handle is specified. 
!
!
!
Errors
If the function returns -1, use the Standard Runtime Library (SRL) Standard Attribute function 
ATDV_LASTERR( ) to obtain the error code or use ATDV_ERRMSGP( ) to obtain a descriptive 
error message. One of the following error codes may be returned: 
EDX_BADPARM
Parameter error
EDX_SH_BADEXTTS
TDM bus time slot is not supported at current clock rate
EDX_SH_BADINDX
Invalid Switch Handler index number
EDX_SH_BADTYPE
Invalid local time slot channel type (voice, analog, etc.)
Name:
int dx_getctinfo(chdev, ct_devinfop)
Inputs:
int chdev
valid channel device handle
CT_DEVINFO *ct_devinfop
pointer to device information structure
Returns:
0 on success
-1 on error
Includes:
srllib.h
dxxxlib.h
Category:
TDM Routing
Mode:
synchronous
Platform:
DM3, Springware, Intel® NetStructure™ IPT Series  
Parameter
Description
chdev 
specifies the valid voice channel handle obtained when the channel was 
opened using 
ct_devinfop 
specifies a pointer to the 
 structure that will contain the 
voice channel device information