DMXGetInputAttributes(3)

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)

---

Free and Open Source Software