Intel 05-1832-002 User Manual

Page of 564
Voice API for Windows Operating Systems Library Reference — November 2003
255
get echo cancellation resource transmit time slot number — dx_getxmitslotecr( )
dx_getxmitslotecr( )
get echo cancellation resource transmit time slot number
!
!
!
Description
The dx_getxmitslotecr( ) function returns the transmit time slot number assigned to the echo 
cancellation resource (ECR) of the specified voice channel device. The time slot information is 
contained in an SC_TSINFO structure. For more information on this structure, see 
Note:
The ECR functions have been replaced by the continuous speech processing (CSP) API functions. 
CSP provides enhanced echo cancellation. For more information, see the Continuous Speech 
Processing API Programming Guide
 and Continuous Speech Processing API Library Reference.
!
!
!
Cautions
This function fails when:
An invalid channel device handle is specified.
The ECR feature is not enabled on the board specified.
The ECR feature is not supported on the board 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
Name:
int dx_getxmitslotecr(chdev,  sc_tsinfop)
Inputs:
int chdev
valid channel device handle
SC_TSINFO *sc_tsinfop
pointer to TDM bus time slot information structure
Returns:
0 on success
-1 on error
Includes:
srllib.h
dxxxlib.h
Category:
Echo Cancellation Resource
Mode:
synchronous
Platform:
Springware
Parameter
Description
chdev 
specifies the voice channel device handle obtained when the channel was 
opened using 
sc_tsinfop 
specifies a pointer to the data structure