dt_unlisten( )

Description | Cautions | Example | Errors | See also

Name:	int dt_unlisten(devh)
Inputs:	int devh	digital network interface device handle
Returns:	0 on success
	-1 on error
Includes:	srllib.h
	dtilib.h
Category:	SCbus Routing
Mode:	Synchronous

Description

The dt_unlisten( ) function disconnects digital receive channel from SCbus. This function disconnects the digital receive (listen) channel (T-1/E-1 time slot) from the SCbus time slot it was listening to.

Calling the dt_listen( ) function to connect to a different SCbus time slot will automatically break an existing connection. Thus, when changing connections, you need not call the dt_unlisten( ) function.

NOTE:

SCbus convenience function nr_scunroute( ) includes dt_unlisten( ) functionality. See the SCbus Routing Guide for more information on convenience functions.

Parameter	Description
devh:	Specifies a valid digital network interface time slot device handle returned by a call to dt_open( )

Cautions

This function will fail when:

• An invalid device handle is specified.
• If called to disconnect a PEB time slot.

Example

#include <windows.h>  
#include <srllib.h>  
#include <dtilib.h>  
#include <errno.h>  
main( )  
{  
   int devh;                 /* Digital channel (time slot) device handle */  
   /* Open board 1 time slot 1 device */  
   if ((devh = dt_open("dtiB1T1", 0)) == -1) {  
      printf("Cannot open time slot dtiB1T1.  errno = %d", errno);  
      exit(1);  
   }  
   /* Disconnect receive of board 1, time slot 1 from all SCbus time slots */  
   if (dt_unlisten(devh) == -1) {  
      printf("Error message = %s", ATDV_ERRMSGP(devh));  
      exit(1);  
}

Errors

If the function returns -1, use the SRL Standard Attribute function ATDV_LASTERR( ) to obtain the error code or use ATDV_ERRMSGP( ) to obtain a descriptive error message. The error codes returned by ATDV_LASTERR( ) are:

Equate	Returned When
EDT_BADBRDERR	Board missing or defective
EDT_BADCMDERR	Invalid command parameter to driver
EDT_FWERR	Firmware returned an error
EDT_INVTS	Invalid time slot device handle
EDT_INVMSG	Invalid message
EDT_SH_BADLCLTS	Invalid local time slot number
EDT_SH_BADEXTTS	External time slot unsupported at current clock rate
EDT_SH_BADINDX	Invalid Switch Handler library index number
EDT_SH_BADMODE	Invalid Switch Handler bus configuration
EDT_SH_BADTYPE	Invalid local time slot type
EDT_SH_LCLDSCNCT	Local time slot is already disconnected from SCbus
EDT_SH_LIBBSY	Switch Handler library busy
EDT_SH_LIBNOTINIT	Switch Handler library is uninitialized
EDT_SH_MISSING	Switch Handler is not present
EDT_SH_NOCLK	Switch Handler clock fallback failed
EDT_SYSTEM	Windows system error
EDT_TMOERR	Timed out waiting for reply from firmware

See also

• dt_listen( )

Click here to contact Dialogic Customer Engineering