NAME

       DMXGetInputAttributes - determine input device attributes

SYNOPSIS

       #include <X11/extensions/dmxext.h>

       Bool DMXGetInputAttributes(Display *dpy,
                                  int id,
                                  DMXInputAttributes *attr);

DESCRIPTION

       DMXGetInputAttributes()  returns  information  about  the  input device specified with id.
       This information cannot be obtained from the XListInputDevices(3) call.  id is the same as
       that  used  by  the XListInputDevices(3) call, and must be in the range 0 to one less than
       the value returned by DMXGetInputCount(3), inclusive.

       The DMXInputAttributes structure is:

       typedef struct {
           DMXInputEnum inputType;
           int          physicalScreen;
           int          physicalId;
           Bool         isCore;
           Bool         sendsCore;
           const char   *name;
           Bool         detached;
       } DMXInputAttributes;

       The value of inputType will always be valid, and will have one of  the  following  values,
       depending   on   the   type  of  input:  DMXLocalInputType  ,   DMXConsoleInputType  ,  or
       DMXBackendInputType .

       For local devices, all other fields returned, except isCore  and  sendsCore , are invalid.

       For console devices, physicalScreen  and  physicalID will be invalid, and name will return
       the name of the X server on which the console window is displayed.

       For back-end devices, physicalScreen will identify the back-end display and can be used as
       an argument to DMXGetScreenAttributes(3) to obtain more information;  physicalId  will  be
       the XInput device id on the back-end X server; and name will be invalid (since it does not
       provide    any    additional    information    that    cannot     be     obtained     with
       DMXGetScreenAttributes(3)).

       If  isCore  is  True, then this device is active as a true core input device and will send
       core events.  If sendsCore is True, then this device is an XInput  extension  device,  but
       sends  core  events  instead of extension events.  This behavior is different from that of
       XFree86 or Xorg, where XInput extension devices may send both extension  events  and  core
       events.

       If  detached  is True, then this device has been detached and is no longer producing input
       events.  The device may be reattached using DMXAddInput(3).

RETURN VALUE

       DMXGetInputAttributes() returns True unless there is a protocol error.

       DMXGetInputAttributes() can generate BadValue (if the value of id is out of range).

SEE ALSO

       DMXGetInputCount(3),  XListInputDevices(3),   DMXGetScreenAttributes(3),   DMXAddInput(3),
       DMX(3), Xdmx(1)