XHPAcknowledge(3X) — Subroutines
Series 300 and 800 Only
NAME
XHPAcknowledge - Send an Acknowledge to an extended input device.
SYNOPSIS
#include <X11/XHPlib.h>
XHPAcknowledge (display, deviceid, acknowledge)
Display∗display;
XIDdeviceid;
unsigned 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 function 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 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 function.
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