Intel 05-1832-002 User Manual

Page of 564
Voice API for Windows Operating Systems Library Reference — November 2003
433
disable echo cancellation resource (ECR) mode — dx_unlistenecr( )
dx_unlistenecr( )
disable echo cancellation resource (ECR) mode
!
!
!
Description
The dx_unlistenecr( ) function disables echo cancellation resource (ECR) mode on the voice 
channel and sets the channel back into standard voice processing (SVP) mode echo cancellation.
Notes: 1. Calling th
 or 
 function to connect to a different TDM bus time 
slot automatically breaks an existing connection. Thus, when changing connections, you do not 
need to call the dx_unlistenecr( ) function. 
2. 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
Invalid parameter
Name:
int dx_unlistenecr(chdev)
Inputs:
int chdev
voice channel device handle
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 valid channel device handle obtained when the channel was opened 
using dx_open( )