dt_close( )

Description | Cautions | Example | Errors | See Also

Name:	int dt_close(devh)
Inputs:	int devh	Digital Network Interface logical board or Digital Network Interface logical time slot device handle
Returns:	0 on success -1 on failure
Includes:	srllib.h dtilib.h
Category:	Resource Management
Mode:	synchronous

Description

The dt_close( ) function closes Digital Network Interface devices opened previously by a call to dt_open( ). The specified device may be either a Digital Network Interface logical board or time slot device. The dt_close( ) function releases the handle and breaks the link between the calling process and the device.

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

Cautions

1. This function will fail if the device handle is invalid.
2. The dt_close( ) function affects only the link between the calling process and the device. Other processes are unaffected by dt_close( ).
3. If event notification is active for the device to be closed, call the SRL sr_dishdlr( ) function prior to calling dt_close( ).
4. A call to dt_close( ) does not affect the configuration of the device.
5. Devices should never be closed using the close( ) function.

Example

#include <windows.h>  /* For Windows applications only */  
#include <srllib.h>  
#include <dtilib.h>  
#include <errno.h>  
   
main()  
{  
   int devh;          /* Board device handle */  
   
   /*  
    * Open board 1 device  
    */  
   if ( ( devh = dt_open( "dtiB1", 0 ) ) == -1 ) {  
      printf( "Cannot open board dtiB1.  errno = %d", errno );  
      exit( 1 );  
   }  
   
   /*  
    *   Continue processing  
    */  
               .  
               .  
               .  
   /*  
    * Done processing - close device.  
    */  
   
   if ( dt_close( devh ) == -1 ) {  
      printf( "Cannot close board dtiB1.  errno = %d", errno );  
   }  
}

Errors

If the function returns -1, use the SRL Standard Attribute function ATDV_LASTERR( ) to obtain the following error value:

• EDT_SYSTEM - system error - check the global variable errno for more information about the error.

See Also

• dt_open( )

Click here to contact Dialogic Customer Engineering