XSGIDeviceControl(3X11) XSGIMisc XSGIDeviceControl(3X11)
NAME
XSGIDeviceControl, XSGIDeviceQuery - set/query device
characteristics of Xsgi(1) input devices
SYNTAX
#include <X11/extensions/SGIMisc.h>
Bool XSGIDeviceControl(
Display *display,
int device_id,
char *name,
char *value
)
Bool XSGIDeviceQuery(
Display *display,
int device_id,
char *name,
char *value
)
ARGUMENTS
display Specifies the connection to Xsgi(1).
device_id Specifies the id of the device to be accessed.
name Specifies the name of the device control to be
set or queried.
value Specifies the value to be set for a device
control, or the location to store the value for
a device query.
DESCRIPTION
These functions are part of the XSGIMisc extension.
XSGIMiscQueryExtension(3X11) should be used to determine if
the extension is supported before calling these functions.
Device controls represent characteristics of X input devices
that can be changed. See input(7) for a description of X
input devices and common device controls. Specific devices
may implement other device controls.
XSGIDeviceControl returns True if the device control
specified by name can be set to the specified value.
XSGIDeviceQuery returns True if name specifies a device
control or other value that can be queried for the device.
The array pointed to by value should be large enough to
contain 24 bytes.
The device_id used in these calls is the value returned by
Page 1 (printed 7/20/06)
XSGIDeviceControl(3X11) XSGIMisc XSGIDeviceControl(3X11)XListInputDevices(3X11). The device should be opened using
XOpenDevice(3X11) before calling either of these functions.
On platforms running XFree86(1) instead of Xsgi(1),
XSGIDeviceControl and XSGIDeviceQuery return BadRequest
errors as they are not implemented.
SEE ALSO
XSGIMiscQueryExtension(3X11), XListInputDevices(3X11),
XOpenDevice(3X11), input(7)
Page 2 (printed 7/20/06)