Filter
Top Products
Voice API for Windows Operating Systems Library Reference — November 2003 41
connect analog receive channel to TDM bus time slot — ag_listen( )
ag_listen( )
connect analog receive channel to TDM bus time slot
!
!!
! Description
The ag_listen( ) function connects an analog receive channel to a TDM bus time slot. This function
uses the information stored in the SC_TSINFO data structure to connect the analog receive (listen)
channel to a TDM bus time slot. This function sets up a half-duplex connection. For a full-duplex
connection, the receive (listen) channel of the other device must be connected to the analog
transmit channel.
Due to analog signal processing on voice boards with on-board analog devices, a voice device and
its corresponding analog device (analog device 1 to voice device 1, etc.) comprise a single channel.
At system initialization, default TDM bus routing is to connect these devices in full-duplex
communications.
Note: Routing convenience function nr_scroute( ) includes ag_listen( ) functionality.
Although multiple analog channels may listen (be connected) to the same TDM bus time slot, the
analog receive (listen) channel can connect to only one TDM bus time slot.
!
!!
! Cautions
This function will fail when an invalid channel handle or invalid TDM bus time slot number is
specified.
Name: int ag_listen (chdev, sc_tsinfop)
Inputs: int chdev
• valid analog 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: Routing
Mode: synchronous
Platform: Springware
Parameter Description
chdev specifies the valid analog channel device handle obtained when the
channel was opened using dx_open( )
sc_tsinfop specifies a pointer to the SC_TSINFO structure. For more information on
this structure, see SC_TSINFO, on page 529.