Filter
Top Products
Voice API for Windows Operating Systems Library Reference — November 2003 431
disconnect voice receive channel from TDM bus — dx_unlisten( )
dx_unlisten( )
disconnect voice receive channel from TDM bus
!
!!
! Description
The dx_unlisten( ) function disconnects the voice receive (listen) channel from the TDM bus.
Calling the dx_listen( ) 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_unlisten( ) function first.
!
!!
! Cautions
• This function will fail when an invalid channel device handle is specified.
• On DM3 boards, this function is supported in a flexible routing configuration but not a fixed
routing configuration. This document assumes that a flexible routing configuration is the
configuration of choice. For more information on API restrictions in a fixed routing
configuration, see the Voice API Programming Guide.
!
!!
! 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_BADCMD
Command is not supported in current bus configuration
EDX_SH_BADEXTTS
TDM bus time slot is not supported at current clock rate
Name: int dx_unlisten(chdev)
Inputs: int chdev
• voice channel device handle
Returns: 0 on success
-1 on error
Includes: srllib.h
dxxxlib.h
Category: TDM Routing
Mode: synchronous
Platform: DM3, Springware
Parameter Description
chdev specifies the valid channel device handle obtained when the channel was opened
using dx_open( )