d42_brdstatus( )

Description | Cautions | Example | Errors

Name:	int d42_brdstatus(devh, buffstatus, bufferp)
Inputs:	int devh	board descriptor
	char *buffstatus	pointer to buffer containing board status information
	char *bufferp	reserved for future use
Returns:	ED42_NOERROR -1	if success
Includes:	D42LIB.H
Mode:	synchronous
Supports:	D/42-SL, D/42-SX, D/42-NS, D/42-NE2

Description

The d42_brdstatus( ) function retrieves the current D/42-xx board status and places it in an application buffer. The board status is a bit mask representing the status of the board (see below) on a per board basis. The application buffer (buffstatus) that will contain the board status information must be 1 byte.

bit0	first channel on board		1=OK, 0=no communication
bit1	second channel on board		1=OK, 0=no communication
bit2	third channel on board		1=OK, 0=no communication
bit3	fourth channel on board		1=OK, 0=no communication
bits 4-7	reserved for future use
Parameter		Description
devh:		specifies the valid board device descriptor obtained by a call to dx_open( )
buffstatus:		pointer to the 1-byte application buffer where the board status is placed
bufferp:		pointer to an additional 48-byte plus 1 NULL byte application buffer (reserved for future use)

Cautions

The character pointer bufferp is required. The associated buffer must be 49 bytes.

Example

void main(void)  
	{  
	int		devh;  
	int		rc = 0;  
	char		buffstatus;  
	char		bufferp[49];  
	/* Open Board Device */  
	if ( (devh = dx_open("dxxxB1C1",NULL))==-1)  
		{  
		printf("Error dx_open( )\n");  
		exit(-1);  
		} /* End dx_open */  
	/* Get the board status Information */  
	if ( (rc = d42_brdstatus(devh, &buffstatus, bufferp)) == -1)  
		{  
		printf("Error d42_brdstatus( )\n");  
		dx_close(devh);  
		exit(-1);  
		} /* End d42_brdstatus*/  
 	printf("Board Status = %X\n",buffstatus);  
	dx_close(devh);  
	}	/* End main */

Errors

If this function returns -1 to indicate a failure, use ATDV_LASTERR( ) and ATDV_ERRMSGP( ) to retrieve one of the following (most common) errors. For a complete list of error codes and definitions, refer to Appendix C.

ED42_FWREQFAILURE	Firmware error
ED42_BADDEVICE	Invalid or wrong device handle
ED42_UNKNOWNBOARD	Unknown D/42 board type
ED42_INVALARG	Invalid argument passed to function
DXLIB_INVNRB	Internal voice library error

Click here to contact Dialogic Customer Engineering