ATDT_IDLEST( )

Description | Cautions | Example | Errors | See Also

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

Description

The ATDT_IDLEST( ) function returns the current idle state of the Digital Network Interface time slot specified in devh. "Idling" transmits silence to the network for the selected time slot.

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 in dtilib.h.

• DTIS_ENABLE - silence insertion is enabled
• DTIS_DISABLE - silence insertion is disabled

To determine if a time slot is idling, compare the value of the returned integer with the provided defines.

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;                 /* Time slot idle state mode */  
   
   /*  
    * 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 silence insertion mode  
    */  
   if ( ( mode = ATDT_IDLEST( devh ) ) == AT_FAILURE ) {  
      printf( "Error message = %s.",ATDV_ERRMSGP( devh ) );  
      exit( 1 );  
   }  
   
   switch ( mode ) {  
   case DTIS_ENABLE:  
      printf( "Time slot 1 on board 1 has silence insertion enabled\n" );  
      break;  
   case DTIS_DISABLE:  
      printf( "Time slot 1 on board 1 has silence insertion disabled\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_INVTS - invalid Digital Network Interface logical time slot device handle
• EDT_INVMSG - invalid message
• 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_setidle( )

Click here to contact Dialogic Customer Engineering