Filter
Top Products
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 the dx_listenecr( ) or dx_listenecrex( ) 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( )