d42_chnstatus( )

Description | Cautions | Example | Errors | See Also

Name:	int d42_chnstatus(devh, statusp, bufferp)
Inputs:	int devh	channel descriptor
	char *statusp	pointer to buffer containing channel status information
	char *bufferp	reserved for future use
Returns:	0 -1	if success
Includes:	D42LIB.H
Mode:	synchronous

Description

The d42_chnstatus( ) function retrieves the current channel status and places it in an application buffer. The application buffer (statusp) that will contain the channel status information must be one byte. The channel status is a single bit (bit 0) representing the status of the channel device.

Parameter	Description
devh:	specifies the valid channel device descriptor obtained by a call to dx_open( )
statusp:	pointer to a 1-byte application buffer. The application buffer will contain a non-zero value if channel is communicating with the switch. non-zero = OK 0 = no communications
bufferp:	pointer to an additional 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          bufferp[49];  
     char          status;  
/* Open Channel Device */  
if ( (devh = dx_open("dxxxB1C1",NULL))==-1)  
          {  
printf("Error dx_open()\n");  
exit(-1);  
          } /* End dx_open */  
/* Get the channel status Information */  
if ( (rc = d42_chnstatus(devh, &statusp, bufferp)) == -1)  
          {  
printf("Error d42_chnstatus():\n");  
dx_close(devh);  
exit(-1);  
          } /* End d42_chnstatus*/  
if (status)  
          {  
printf("Channel Communication OK\n");  
          }  
else  
          {  
printf("No Channel Communication\n");  
          }  
dx_close(devh);  
}     /* End main */

Errors

If this function returns -1 to indicate a failure, one of the following (most common) codes will be contained in dx_errno. For a complete list of error codes and definitions, refer to Appendix C.

ED42_BADDEVICE	Invalid or wrong device handle
ED42_UNSUPPORTED	Function not supported on this board
ED42_SYSTEM	System level error
ED42_INVALARG	Invalid argument passed to function

See Also

• d42_brdstatus( )

Click here to contact Dialogic Customer Engineering