Intel 05-1832-002 IP Phone User Manual


 
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 CT_DEVINFO 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 dx_open( )
ct_devinfop specifies a pointer to the CT_DEVINFO structure that will contain the
voice channel device information