Filter
Top Products
44 Voice API for Windows Operating Systems Library Reference — November 2003
ag_unlisten( ) — disconnect analog receive channel from TDM bus
ag_unlisten( )
disconnect analog receive channel from TDM bus
!
!!
! Description
The ag_unlisten( ) function disconnects an analog receive channel from the TDM bus. This
function disconnects the analog receive (listen) channel from the TDM bus time slot it was
listening to.
Calling ag_listen( ) to connect to a different TDM bus time slot will automatically break an
existing connection. Thus, when changing connections, you need not call the ag_unlisten( )
function first.
Note: Routing convenience function nr_scunroute( ) includes ag_unlisten( ) functionality.
!
!!
! Cautions
This function will fail when 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_BADCMD
Command is not supported in current bus configuration
EDX_SH_BADINDX
Invalid Switch Handler index number
Name: int ag_unlisten(chdev)
Inputs: int chdev
• analog channel device handle
Returns: 0 on success
-1 on error
Includes: srllib.h
dxxxlib.h
Category: Routing
Mode: synchronous
Platform: Springware
Parameter Description
chdev specifies the valid channel device handle obtained when the channel was opened
using dx_open( )