XHPSetInputDevice(3X)													     XHPSetInputDevice(3X)

NAME

       XHPSetInputDevice - Open a device for X input.

SYNOPSIS

       #include <X11/XHPlib.h>

       int XHPSetInputDevice (display, deviceid, mode)
	    Display   *display;
	    XID       deviceid;
	    int       mode;

ARGUMENTS

       display	   Specifies the connection to the X server.

       deviceid    Specifies the ID of the desired device.

       mode	   Specifies the desired mode of access.

DESCRIPTION

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

       This request is provided to support input devices other than the X keyboard device and the X pointer device.

       Client programs use the XHPSetInputDevice to open an input device for extended input and to close the device.  XHPSetInputDevice requires a
       mode parameter that specifies the request being requested (ON or OFF) and, if the request is ON,  whether the device should be opened as an
       extension to the X keyboard or pointer (SYSTEM_EVENTS), or as an independently selectable device (DEVICE_EVENTS).  The value of the mode
       parameter is set by ORing together the above constants, which may be obtained by including the file <X11/XHPlib.h>.

       To open an input device as a device whose input can be selected independent of the X keyboard and X pointer, the client program would use
       the mode ON OR'd with the mode DEVICE_EVENTS.  To open an input device as an extension of the X keyboard or X pointer, the client program
       would use the mode ON or'd with the mode SYSTEM_EVENTS.	Valid values for the mode parameter are:

       ON | SYSTEM_EVENTS
       ON | DEVICE_EVENTS
       OFF

       This request will fail with a BadMode error if some other client is already using the device with a different mode.

DIAGNOSTICS

       BadMode	   An invalid mode was specified.

       BadDevice   An invalid device ID was specified.

RETURN VALUE

       none

FILES

       /usr/include/X11/XHPlib.h

ORIGIN

       Hewlett-Packard Company

SEE ALSO

       XHPListInputDevices(3x)
       XHPGetExtEventMask(3x)
       XHPSelectExtensionEvent(3x)

X Version 11							     Release 5						     XHPSetInputDevice(3X)