Home | History | Annotate | Download | only in ddk
      1 /*
      2  * hidclass.h
      3  *
      4  * HID class driver interface
      5  *
      6  * This file is part of the w32api package.
      7  *
      8  * Contributors:
      9  *   Created by Casper S. Hornstrup <chorns (at) users.sourceforge.net>
     10  *
     11  * THIS SOFTWARE IS NOT COPYRIGHTED
     12  *
     13  * This source code is offered for use in the public domain. You may
     14  * use, modify or distribute it freely.
     15  *
     16  * This code is distributed in the hope that it will be useful but
     17  * WITHOUT ANY WARRANTY. ALL WARRANTIES, EXPRESS OR IMPLIED ARE HEREBY
     18  * DISCLAIMED. This includes but is not limited to warranties of
     19  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
     20  *
     21  */
     22 
     23 #ifndef __HIDCLASS_H
     24 #define __HIDCLASS_H
     25 
     26 #include "hidpi.h"
     27 
     28 #ifdef __cplusplus
     29 extern "C" {
     30 #endif
     31 
     32 #define HID_REVISION                      0x00000001
     33 
     34 DEFINE_GUID (GUID_DEVINTERFACE_HID, \
     35   0x4D1E55B2L, 0xF16F, 0x11CF, 0x88, 0xCB, 0x00, 0x11, 0x11, 0x00, 0x00, 0x30);
     36 DEFINE_GUID (GUID_HID_INTERFACE_NOTIFY, \
     37   0x2c4e2e88L, 0x25e6, 0x4c33, 0x88, 0x2f, 0x3d, 0x82, 0xe6, 0x07, 0x36, 0x81);
     38 DEFINE_GUID (GUID_HID_INTERFACE_HIDPARSE, \
     39   0xf5c315a5, 0x69ac, 0x4bc2, 0x92, 0x79, 0xd0, 0xb6, 0x45, 0x76, 0xf4, 0x4b);
     40 
     41 #define GUID_CLASS_INPUT GUID_DEVINTERFACE_HID
     42 
     43 #define GUID_CLASS_INPUT_STR "4D1E55B2-F16F-11CF-88CB-001111000030"
     44 
     45 
     46 #define HID_CTL_CODE(id) \
     47   CTL_CODE (FILE_DEVICE_KEYBOARD, (id), METHOD_NEITHER, FILE_ANY_ACCESS)
     48 #define HID_BUFFER_CTL_CODE(id) \
     49   CTL_CODE (FILE_DEVICE_KEYBOARD, (id), METHOD_BUFFERED, FILE_ANY_ACCESS)
     50 #define HID_IN_CTL_CODE(id) \
     51   CTL_CODE (FILE_DEVICE_KEYBOARD, (id), METHOD_IN_DIRECT, FILE_ANY_ACCESS)
     52 #define HID_OUT_CTL_CODE(id) \
     53   CTL_CODE (FILE_DEVICE_KEYBOARD, (id), METHOD_OUT_DIRECT, FILE_ANY_ACCESS)
     54 
     55 
     56 #define IOCTL_GET_PHYSICAL_DESCRIPTOR         HID_OUT_CTL_CODE(102)
     57 #define IOCTL_HID_FLUSH_QUEUE                 HID_CTL_CODE(101)
     58 #define IOCTL_HID_GET_COLLECTION_DESCRIPTOR   HID_CTL_CODE(100)
     59 #define IOCTL_HID_GET_COLLECTION_INFORMATION  HID_BUFFER_CTL_CODE(106)
     60 #define IOCTL_HID_GET_FEATURE                 HID_OUT_CTL_CODE(100)
     61 #define IOCTL_HID_GET_HARDWARE_ID             HID_OUT_CTL_CODE(103)
     62 #define IOCTL_HID_GET_INDEXED_STRING          HID_OUT_CTL_CODE(120)
     63 #define IOCTL_HID_GET_INPUT_REPORT            HID_OUT_CTL_CODE(104)
     64 #define IOCTL_HID_GET_MANUFACTURER_STRING     HID_OUT_CTL_CODE(110)
     65 #define IOCTL_GET_NUM_DEVICE_INPUT_BUFFERS    HID_BUFFER_CTL_CODE(104)
     66 #define IOCTL_HID_GET_POLL_FREQUENCY_MSEC     HID_BUFFER_CTL_CODE(102)
     67 #define IOCTL_HID_GET_PRODUCT_STRING          HID_OUT_CTL_CODE(111)
     68 #define IOCTL_HID_GET_SERIALNUMBER_STRING     HID_OUT_CTL_CODE(112)
     69 #define IOCTL_HID_SET_FEATURE                 HID_IN_CTL_CODE(100)
     70 #define IOCTL_SET_NUM_DEVICE_INPUT_BUFFERS    HID_BUFFER_CTL_CODE(105)
     71 #define IOCTL_HID_SET_OUTPUT_REPORT           HID_IN_CTL_CODE(101)
     72 #define IOCTL_HID_SET_POLL_FREQUENCY_MSEC     HID_BUFFER_CTL_CODE(103)
     73 
     74 #define IOCTL_HID_GET_DRIVER_CONFIG           HID_BUFFER_CTL_CODE(100)
     75 #define IOCTL_HID_SET_DRIVER_CONFIG           HID_BUFFER_CTL_CODE(101)
     76 #define IOCTL_HID_GET_MS_GENRE_DESCRIPTOR     HID_OUT_CTL_CODE(121)
     77 
     78 /* FIXME: these values are wrong! */
     79 #define IOCTL_HID_GET_STRING                  0
     80 #define IOCTL_HID_GET_DEVICE_ATTRIBUTES       1
     81 #define IOCTL_HID_GET_DEVICE_DESCRIPTOR       2
     82 #define IOCTL_HID_READ_REPORT                 3
     83 #define IOCTL_HID_WRITE_REPORT                4
     84 #define IOCTL_HID_GET_REPORT_DESCRIPTOR       5
     85 
     86 typedef enum _HID_STRING_TYPE
     87 {
     88 	HID_STRING_INDEXED = 0,
     89 	HID_STRING_ID_IMANUFACTURER,
     90 	HID_STRING_ID_IPRODUCT,
     91 	HID_STRING_ID_ISERIALNUMBER,
     92 	HID_STRING_MAX
     93 } HID_STRING_TYPE;
     94 
     95 enum DeviceObjectState {
     96   DeviceObjectStarted = 0,
     97   DeviceObjectStopped,
     98   DeviceObjectRemoved
     99 };
    100 
    101 typedef VOID (NTAPI *PHID_STATUS_CHANGE)(
    102   PVOID  Context,
    103   enum DeviceObjectState  State);
    104 
    105 typedef NTSTATUS (NTAPI *PHIDP_GETCAPS)(
    106   IN PHIDP_PREPARSED_DATA  PreparsedData,
    107   OUT PHIDP_CAPS  Capabilities);
    108 
    109 typedef struct _HID_COLLECTION_INFORMATION {
    110   ULONG  DescriptorSize;
    111   BOOLEAN  Polled;
    112   UCHAR  Reserved1[1];
    113   USHORT  VendorID;
    114   USHORT  ProductID;
    115   USHORT  VersionNumber;
    116 } HID_COLLECTION_INFORMATION, *PHID_COLLECTION_INFORMATION;
    117 
    118 typedef struct _HID_DRIVER_CONFIG {
    119   ULONG  Size;
    120   ULONG  RingBufferSize;
    121 } HID_DRIVER_CONFIG, *PHID_DRIVER_CONFIG;
    122 
    123 typedef struct _HID_INTERFACE_HIDPARSE {
    124 #ifdef __cplusplus
    125   INTERFACE  i;
    126 #else
    127   /* GCC doesn't support including unnamed structs, so INTERFACE is
    128      expanded here */
    129   USHORT  Size;
    130   USHORT  Version;
    131   PVOID  Context;
    132   PINTERFACE_REFERENCE  InterfaceReference;
    133   PINTERFACE_DEREFERENCE  InterfaceDereference;
    134 #endif
    135   PHIDP_GETCAPS  HidpGetCaps;
    136 } HID_INTERFACE_HIDPARSE, *PHID_INTERFACE_HIDPARSE;
    137 
    138 typedef struct _HID_INTERFACE_NOTIFY_PNP {
    139 #ifdef __cplusplus
    140   INTERFACE  i;
    141 #else
    142   /* GCC doesn't support including unnamed structs, so INTERFACE is
    143      expanded here */
    144   USHORT  Size;
    145   USHORT  Version;
    146   PVOID  Context;
    147   PINTERFACE_REFERENCE  InterfaceReference;
    148   PINTERFACE_DEREFERENCE  InterfaceDereference;
    149 #endif
    150   PHID_STATUS_CHANGE  StatusChangeFn;
    151   PVOID  CallbackContext;
    152 } HID_INTERFACE_NOTIFY_PNP, *PHID_INTERFACE_NOTIFY_PNP;
    153 
    154 typedef struct _HID_XFER_PACKET {
    155   PUCHAR  reportBuffer;
    156   ULONG  reportBufferLen;
    157   UCHAR  reportId;
    158 } HID_XFER_PACKET, *PHID_XFER_PACKET;
    159 
    160 #ifdef __cplusplus
    161 }
    162 #endif
    163 
    164 #endif /* __HIDCLASS_H */
    165