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)