XHPAcknowledge(3X)XHPAcknowledge(3X)NAMEXHPAcknowledge - Send an Acknowledge to an extended input device.
SYNOPSIS
#include <X11/XHPlib.h>
int XHPAcknowledge (display, deviceid, acknowledge)
Display *display;
XID deviceid;
int acknowledge;
ARGUMENTS
display Specifies the connection to the X server.
deviceid Specifies the ID of the desired device.
acknowledge Specifies the acknowledge to be sent. Valid values are:
GENERAL_ACKNOWLEDGE, ACKNOWLEDGE_1, ACKNOWLEDGE_2,
ACKNOWLEDGE_3, ACKNOWLEDGE_4, ACKNOWLEDGE_5, ACKNOWLEDGE_6,
ACKNOWLEDGE_7.
DESCRIPTION
This request is part of an HP-proprietary extension to X. Its
functionality has been superseded by the standard
XChangeFeedbackControl request. You should use XChangeFeedbackControl
instead of XHPAcknowledge if possible.
This request sends an acknowledge to an input device. This allows a
previously received prompt to be turned off.
A prompt is an audio or visual indication that the program controlling
the input device is ready for input. The LED on an HP46086A buttonbox
is an example of a prompt. A program may indicate its 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 acknowledge was specified.
FILES
/usr/include/X11/XHPlib.h
ORIGIN
Hewlett-Packard Company
SEE ALSOXHPListInputDevices(3x)XHPPrompt(3x)X Version 11 Release 5 XHPAcknowledge(3X)