d42_writetodisplay( )

Description | Cautions | Example | Errors

Name:	int d42_writetodisplay(devh, bufferp)
Inputs:	int devh	channel descriptor
	char *bufferp	pointer to a buffer containing ASCII character string data to be displayed
Returns:	ED42_NOERROR -1	if success
Includes:	D42LIB.H
Mode:	synchronous
Supports:	D/42-NS

Description

The d42_writetodisplay( ) function writes to the phone set display the ASCII string contents of bufferp. This function requires that a phone extension feature session be previously opened on the channel through the d42_openfeaturesession( ) function, which associates a telephone extension with a channel number and provides information about the display used by the phone set.

Parameter	Description
devh:	specifies the valid channel device descriptor obtained by a call to dx_open( ) and on which a feature session is has been opened
bufferp:	pointer to an application buffer containing a NULL terminated ASCII data string that is to be displayed on the telephone set display. The buffer size is determined by the maximum amount of data that can be sent to the telephone set display, which was returned by the d42_openfeaturesession( ) function, plus one NULL byte.

Cautions

Only one feature session can be open on a channel at any time.

Example

void D42_Test_FeatureSession( )  
{  
char szExt[5];  
char *cpNull = NULL;  
char cpErrStr[MAX_PATH];  
int  TermType;  
int eventMask;  
	// extension fpr which we are opening a feature session  
	sprintf(szExt, "1234");  
	eventMask = D42_EVT_SOFTKEY | D42_EVT_ASYNCCLOSEFEATSESSION;  
	if (d42_openfeaturesession(G_d42chdev, szExt, &TermType, eventMask) == -1)  
	{  
		printf("Error d42_openfeaturesession( )\n");  
	}  
	if  (d42_writetodisplay(G_d42chdev, "FtrSs Open") == -1)  
	{  
		printf("Error d42_writetodisplay( )\n");  
	}  
     
	if (d42_closefeaturesession(G_d42chdev) == -1)  
	{  
		printf("Error d42_closefeaturesession( )\n");  
	}  
}	// endof D42_Test_FeatureSession

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_NOFEATURE   SESSION	Function requires an open feature session
ED42_FWREQFAILURE	Firmware error
ED42_BADDEVICE	Invalid or wrong device handle
ED42_UNKNOWNBOARD	Unknown D/42 board type
ED42_UNSUPPORTED	Function not supported on this board
ED42_INVALARG	Invalid argument passed to function
DXLIB_INVNRB	Internal voice library error

Click here to contact Dialogic Customer Engineering