ATDT_STATUS( )

Description | Cautions | Example | Errors | See Also

Name:	long ATDT_STATUS(devh)
Inputs:	int devh	Digital Network Interface logical time slot device handle
Returns:	status of time slot AT_FAILURE if failure
Includes:	srllib.h dtilib.h
Category:	Extended Attribute
Mode:	synchronous

Description

The ATDT_STATUS( ) function returns the current status of the Digital Network Interface time slot specified in devh.

Parameter	Description
devh:	Specifies the valid Digital Network Interface logical time slot device handle returned by a call to dt_open( )

The following defines are provided:

• DTST_INACTIVE - time slot is idle
• DTST_BUSY - time slot is not idle

To determine the status of the time slot, compare the value of the returned integer with the defines listed above.

The time slot is considered busy if it is currently executing a multitasking function, for example, wink signaling.

Cautions

This function will fail if an invalid Digital Network Interface logical 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 */  
   long mode;             /* Current status of time slot */  
   
   /*  
    * 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 );  
   }  
   
   /*  
    * Get current wink status of time slot  
    */  
   if ( ( mode = ATDT_STATUS( devh ) ) == AT_FAILURE ) {  
      printf( "Error message = %s.", ATDV_ERRMSGP( devh ) );  
      exit( 1 );  
   }  
   
   /*  
    * Display it  
    */  
   switch ( mode ) {  
   case DTST_INACTIVE:  
      printf( "Time slot 1 on board 1 is idle\n" );  
      break;  
   case DTST_BUSY:  
      printf( "Time slot 1 on board 1 is busy\n" );  
      break;  
   }  
              .  
              .  
              .  
}

Errors

If the function returns AT_FAILURE, use the SRL Standard Attribute function ATDV_LASTERR( ) to obtain the error code or use ATDV_ERRMSGP( ) to obtain a descriptive error message. See Appendix A - Standard Runtime Library for more information on SRL functions. The error codes returned by ATDV_LASTERR( ) are:

• EDT_BADBRDERR - Digital Network Interface missing or defective
• EDT_BADCMDERR - invalid command parameter to driver
• EDT_INVMSG - invalid message
• EDT_INVTS - invalid Digital Network Interface logical time slot device handle
• EDT_NOMEMERR - cannot map or allocate memory in driver
• EDT_RANGERR - bad/overlapping physical memory range
• EDT_SIZEERR - message too big or too small
• EDT_SKIPRPLYERR - a required reply was skipped
• EDT_SYSTEM - system error. Check the global variable errno for more information about the error.
• EDT_TMOERR - timed out waiting for reply from firmware

Error defines can be found in the file dtilib.h.

See Also

• dt_xmitwink( )

Click here to contact Dialogic Customer Engineering