dt_getxmitslot( )

Description | Cautions | Example | Errors | See Also

Name:	int dt_getxmitslot(devh,sc_tsinfop)
Inputs:	int devh	Digital network interface device time slot
	SC_TSINFO *sc_tsinfop	pointer to SCbus time slot information structure
Returns:	0 on success -1 if error
Includes:	srllib.h dtilib.h
Category:	SCbus Routing
Mode:	synchronous

Description

The dt_getxmitslot( ) function returns the SCbus time slot connected to the transmit of a Digital Network Interface device time slot.

NOTE:

The SCbus convenience function nr_scroute( ) includes dt_getxmitslot( ) functionality; see the Voice Programmer's Guide (for Linux or Windows).

Parameter	Description
devh:	Specifies the valid Digital Network Interface time slot device handle returned by a call to dt_open( )
sc_tsinfop:	Specifies the pointer to the data structure SC_TSINFO

The sc_numts member of the SC_TSINFO structure must be initialized with the number of SCbus time slots requested (1 for a Digital Network Interface device time slot). The sc_tsarrayp member of the SC_TSINFO structure must be initialized with a pointer to a valid array. Upon return from the function, the array will contain the number (between 0 and 1023) of the SCbus time slot on which the Digital Network Interface device time slot transmits. The SC_TSINFO structure is declared as follows:

   typedef struct {  
      unsigned long   sc_numts;  
      long            *sc_tsarrayp;  
   } SC_TSINFO;

A Digital Network Interface device time slot can transmit on only one SCbus time slot.

Cautions

This function will fail when an invalid time slot device handle is specified.

Example

#include <windows.h>         /* For Windows applications only */  
#include <srllib.h>  
#include <dtilib.h>  
#include <errno.h>  
   
main( )  
{  
   int devh;                 /* Time slot device handle */  
   SC_TSINFO sc_tsinfo;      /* Time slot information structure */  
   long scts;                /* SCbus time slot */  
   
   /* Open board 1 time slot 1 for Digital network interface device */  
   if ((devh = dt_open("dtiB1T1", 0)) == -1) {  
      printf("Cannot open time slot dtiB1T1.  errno = %d", errno);  
      exit(1);  
   }  
   
   /* Fill in the SCbus time slot information */  
   sc_tsinfo.sc_numts = 1;  
   sc_tsinfo.sc_tsarrayp = &scts;  
   
   /* Get SCbus time slot connected to transmit of time slot (digital  
   channel) 1 on board 1 */  
   if (dt_getxmitslot(devh, &sc_tsinfo) == -1) {  
      printf("Error message = %s", ATDV_ERRMSGP(devh));  
      exit(1);  
   }  
   
      printf("%s is transmitting on SCbus time slot %d", ATDV_NAMEP(devh),  
      scts);  
}

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:

• 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_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 the 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 - system error
• EDT_TMOERR - Timed out waiting for reply from firmware

See Also

In the SCbus Routing Function Reference:

• ag_listen( )
• dx_listen( )

Click here to contact Dialogic Customer Engineering