Intel 05-1832-002 IP Phone User Manual


 
36 Voice API for Windows Operating Systems Library Reference — November 2003
ag_getctinfo( ) — get information about an analog device
ag_getctinfo( )
get information about an analog device
!
!!
! Description
The ag_getctinfo( ) function returns information about an analog channel on an analog device.
This information is contained in a CT_DEVINFO structure.
!
!!
! Cautions
This function will fail if an invalid 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 library index number
EDX_SH_BADTYPE
Invalid channel type (voice, analog, etc.)
Name: int ag_getctinfo(chdev, ct_devinfop)
Inputs: int chdev
valid analog 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: Routing
Mode: synchronous
Platform: Springware
Parameter Description
chdev specifies the valid analog channel handle obtained when the channel was
opened using dx_open( )
ct_devinfop specifies a pointer to the data structure CT_DEVINFO