ms_unlisten( )

---

Cautions | Errors | Example | See Also

Name:	int ms_unlisten (devh)
Inputs:	int devh	MSI station device handle
Returns:	0 on success -1 on failure
Includes:	srllib.h dtilib.h msilib.h
Category:	TDM Bus Routing
Mode:	asynchronous
Platform:	DI, HDSI, Springware

Description

The ms_unlisten( ) function disconnects the listen (receive) component of a station interface from a TDM bus time slot.

Parameter	Description
devh	the station device handle

Cautions

This function fails when an invalid station device handle is specified.

Errors

If this function returns -1 to indicate failure, obtain the reason for the error by calling the SRL standard attribute function ATDV_LASTERR( ) or ATDV_ERRMSGP( ) to retrieve either the error code or a pointer to the error description, respectively.

Refer to the error type tables found in Chapter 5, "Error Codes".

Example

#include <windows.h>         /* For Windows applications only */
#include  "srllib.h"
#include  "dxxxlib.h"
#include  "dtilib.h"

int       chdev              /* Station device handle */  
/* Open board 1, channel 1 */
if ((chdev = ms_open("msiB1C1",0)) == -1) {
   printf("Cannot open channel msiB1C1. errno = %d", errno);
   exit(1);
}  
/* Disconnect receive of board 1, station 1 from all SCbus time slots */
if (ms_unlisten(chdev) == -1) {
   printf("Error message = %s",ATDV_ERRMSGP(chdev));
   exit(1);
}  

See Also

• ms_listen( )

Click here to contact Telecom Support Resources