Intel 05-1832-002 User Manual

Page of 564
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 
 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 usin
 
ct_devinfop 
specifies a pointer to the data structure