dcb_close( )

Description | Cautions | Example | Errors | See Also

Name:	int dcb_close(devh)
Inputs:	int devh	DCB/SC device handle
Returns:	0 on success
	-1 on failure
Includes:	srllib.h
	dcblib.h
	errno.h
	dtilib.h
	msilib.h
Category:	Device Management
Mode:	synchronous

Description

The dcb_close( ) function closes the DCB/SC device previously opened by dcb_open( ). The devices are either DCB/SC boards or DSPs on the board. The dcb_close( ) function releases the handle.

Parameter	Description
devh:	The valid DCB/SC device handle returned by a call to dcb_open( ).

Cautions

1. This function fails if the device handle is invalid.
2. The dcb_close( ) function affects only the link between the calling process or thread and the device. Other processes or threads are unaffected by dcb_close( ).
3. If event notification is active for the device to be closed, call the SRL sr_dishdlr( ) function prior to calling dcb_close( ).
4. A call to dcb_close( ) does not affect the configuration of the DCB/SC.

Example

#include <windows.h>  
#include <stdio.h>  
#include "srllib.h"  
#include "dtilib.h"  
#include "msilib.h"  
#include "dcblib.h"  
#include "errno.h"  
main()   
{  
   int dspdevh;             /* DSP device descriptor variable */  
   
   /* Open DCB/SC board 1, DSP 2 device */  
   if ((dspdevh = dcb_open("dcbB1D2",0)) == -1) {  
      printf("Cannot open DSP dcbB1D2 : errno = %d", errno);  
      exit(1);  
   }  
   /*  Continue Processing  */  
   /* Done processing - close device */  
   if (dcb_close(dspdevh) == -1) {  
      printf("Cannot close DSP dcbB1D2 : errno = %d", errno);  
      exit(1);  
   }  
}

Errors

The dcb_close( ) function does not return errors in the standard return code format. If an error occurred during the dcb_close( ) call, a -1 will be returned, and the specific error number will be returned in the errno global variable.

See Also

• dcb_open( )

Click here to contact Dialogic Customer Engineering