d42_lcdprompt( )

Description | Cautions | Example | Errors

Name:	int d42_lcdprompt(devh, bufferp)
Inputs:	int devh	channel descriptor
	char *bufferp	pointer to an application buffer containing D/42-SX LCD prompt data
Returns:	ED42_NOERROR -1	if success
Includes:	D42LIB.H
Mode:	synchronous
Supports:	D/42-SX

Description

The d42_lcdprompt( ) function retrieves the current LCD prompt data of the D/42D-SX and places it in an application buffer. The application buffer must be 49 bytes, and will hold the entire bit mask representing the status of each prompt.

Parameter	Description
devh:	specifies the valid channel device descriptor obtained by a call to dx_open( )
bufferp:	pointer to the application buffer; the LCD prompt data is placed here

The LCD prompt data stored in the application buffer is 48 bytes long. Each byte represents a specific prompt on the SUPERSET 4 Feature Display (see Figure 6). Each byte will be either 0x00 (off) or 0x01 (on). Refer to Table 3 for a description of MITEL SUPERSET 4 Feature Display LCD prompts.

For example, if the data for bytes 4, 23, and 29 is 0x01, the prompts for PROGRAM, FWD, and MSG are on. The contents of the application buffer are shown below.

Figure 6. MITEL SUPERSET 4 Prompt Display

Table 3. MITEL SUPERSET 4 Prompt Descriptions

Soft Key	Byte	Prompt	Soft Key	Byte	Prompt
1	0	PROGRAM	4	24	HELP
	1	CAMP		25	SEND
	2	SWAP		26	ADD
	3	PAGE		27	REMINDER
	4	PROGRAM		28	CALL
	5	ON		29	MSG
	6	SPLIT		30	HELD
	7	EXIT		31	REMINDER
2	8	NIGHT	5	32	REDIAL
	9	CALL		33	CANCEL
	10	ON		34	PRIVACY
	11	NAME		35	READ
	12	ANS		36	_
	13	BACK		37	NO
	14	OFF		38	REL
	15	SAVE		39	MSG
3	16	PICKUP	6	40	RELEASE
	17	OVERRIDE		41	HANG
	18	TRANS		42	NEXT
	19	CALL		43	SPEED
	20	e		44	_
	21	OVERRIDE		45	UP
	22	CONF		46	YES
	23	FWD		47	CALL

Cautions

This function is only for the D/42D-SX board. The application buffer must be 49 bytes. The length of the LCD prompt data is 48 bytes and is stored as a bit mask.

Example

void main(void)  
	{  
	int			devh;  
	int			rc = 0;  
	char 		bufferp[49];  
	/* Open Channel Device */  
	if ( (devh = dx_open("dxxxB1C1",NULL))==-1)  
		{  
		printf("Error dx_open( )\n");  
		exit(-1);  
		} /* End dx_open */  
	/* Wait for incoming call */  
	if ( (rc = dx_wtring(devh, 2, DX_ONHOOK, -1))==-1)  
		{  
		printf("Error dx_wtring( )\n");  
		dx_close(devh);  
		exit(-1);  
		}  
	/* Get the LCD Prompt Information */  
	if ( (rc = d42_lcdprompt(devh, bufferp)) == -1)  
		{  
		printf("Error d42_lcdprompt( )\n");  
		dx_close(devh);  
		exit(-1);  
		} /* End d42_lcdprompt*/  
	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.

Click here to contact Dialogic Customer Engineering