Release 5

NAME

XHPPrompt - Send a prompt to an extended input device. 

SYNOPSIS

#include <X11/XHPlib.h>
int XHPPrompt (display, deviceid, prompt)
Display*display;
XIDdeviceid;
unsigned int prompt;

ARGUMENTS

display Specifies the connection to the X server. 

deviceid Specifies the ID of the desired device. 

Prompt Specifies the Prompt to be sent.  Valid values are: GENERAL_PROMPT, PROMPT_1, PROMPT_2, PROMPT_3, PROMPT_4, PROMPT_5, PROMPT_6, PROMPT_7. 

DESCRIPTION

This request is part of an HP-proprietary extension to X.  Its functionality has been superseded by the standard X input device extension XChangeFeedbackControl request.  You should use XChangeFeedbackControl instead of XHPPrompt if possible. 

This request sends a prompt to an input device. 

A prompt is an audio or visual indication that the program controlling the input device is ready for input.  The program may indicate that status by turning on a prompt on the appropriate input device. 

Not all input devices support prompts and acknowledges.  Any device that does support a particular prompt will also support the corresponding acknowledge. 

To determine whether an input device supports a particular prompt and acknowledge, the io_byte field of the XHPDeviceList structure should be examined.  The format of this structure is described in the documentation for the XHPListInputDevices request. 

RETURN VALUE

none

DIAGNOSTICS

BadDevice An invalid device ID was specified. 

BadValue An invalid prompt was specified. 

FILES

/usr/include/X11/XHPlib.h

ORIGIN

Hewlett-Packard Company

SEE ALSO

XHPListInputDevices(3x)
XHPAcknowledge(3x)

Hewlett-Packard Company  —  HP-UX 9.0 August 1992