r~M5G8G!=2!?L-p37%
zU{Q1n4+5ySU!k6Wr9@5U*LAfz?{kocDo@yiqoGR-A>>5PU!HziMob+6P2BldBfi#afyG4)8GTd46s
zml&c#Na274JG|_4YeSp}DI}hR<4;M3$e~mmIi$mp^eCbzLuMFfa1*))sTNn7)rF&r
zE-<9|GScW;hIpeZn4*rZ5m|X5ajWN*AXMlTC<{1F;4Nc=G<@okb&2?->l&fWu}U$F
zMl4;}324Y;jx)#X0jmRxW!ryRycbJd5%Fm9|KaZWt9e<0ErFp-rWoxUkGq&Ns((mx_SAOx!CF)+jYL}4*
zkIl0Pi7Nd7`mfJ8j&h0SUif-9eYV8;pQ0!DOO$$X4CPtmbmDgs7j~jklXR~8B;Nle
zxgwhc?f0zOC8t)eZM&(d_36|~ZtW9at`%qSCK@4#kZOu2+@&HB6;D0_EtP7I_t3`E
z`+uWfe^s@ih9pxEcXbK*t>El3M|R4?@O9Ec2P%P1Cg2D@^6%zP)J2qOz6-2B;O%fO
zIJ^8Vw(J@6>6?mY9Fv~$4>ZSXCXvZA%1YzKqv9DiSR_2-@BHGI!ZSp@hdSe}%q7k}
z7~hzS;?`UEvdgHTH>{oX1>t-H^2C$&^y$TZDmw(
z3XQpCZ#O!neHX-tl3bAGXCgx3_>13(=*i5hpOm#=+4UXG_M3WPuzt+Fn~}
z4!WU!;Ybc|@$vM;vSX|af20aw;TiyeFTm1sD28iy4Wtuh?1X~GS=mwGyshAHKHVu!
z(&)XT;OH58r)X&oAfdSu+r&u?Ex1VU6f2W4`}`=dPAOQ1Qv^e{?f01&?-&8*X%#ba
zFkwi)Y<*?Vn|ql8VwZv#J`Z$^moTdDDtLy&6GOH?stGInjEbq9#~7~d5lujQPeW5r
zcpal9jHkFU#QK&eZNr(7A=@6$8y}f{<{W(Hea7^!vHT6EZH%P2(#;q+OdNew{y;%{
z)2N(DSZzHD&S9;#bj(bNwCAHnM{j&AFrupw6JzK>`
z6@1YMFeBFv4A_1YNr;YpDq{3bsB_GOJ-pw58Qk?SWV_>= 1200
+#pragma warning(push)
+#endif
+#pragma warning(disable:4115) // named type definition in parentheses
+#pragma warning(disable:4201) // nameless struct/union
+#pragma warning(disable:4214) // bit field types other than int
+
+#include
+
+// Please include "hidsdi.h" to use the user space (dll / parser)
+// Please include "hidpddi.h" to use the kernel space parser
+
+//
+// Special Link collection values for using the query functions
+//
+// Root collection references the collection at the base of the link
+// collection tree.
+// Unspecifies, references all collections in the link collection tree.
+//
+#define HIDP_LINK_COLLECTION_ROOT ((USHORT) -1)
+#define HIDP_LINK_COLLECTION_UNSPECIFIED ((USHORT) 0)
+
+
+typedef enum _HIDP_REPORT_TYPE
+{
+ HidP_Input,
+ HidP_Output,
+ HidP_Feature
+} HIDP_REPORT_TYPE;
+
+typedef struct _USAGE_AND_PAGE
+{
+ USAGE Usage;
+ USAGE UsagePage;
+} USAGE_AND_PAGE, *PUSAGE_AND_PAGE;
+
+#define HidP_IsSameUsageAndPage(u1, u2) ((* (PULONG) &u1) == (* (PULONG) &u2))
+
+typedef struct _HIDP_BUTTON_CAPS
+{
+ USAGE UsagePage;
+ UCHAR ReportID;
+ BOOLEAN IsAlias;
+
+ USHORT BitField;
+ USHORT LinkCollection; // A unique internal index pointer
+
+ USAGE LinkUsage;
+ USAGE LinkUsagePage;
+
+ BOOLEAN IsRange;
+ BOOLEAN IsStringRange;
+ BOOLEAN IsDesignatorRange;
+ BOOLEAN IsAbsolute;
+
+ ULONG Reserved[10];
+ union {
+ struct {
+ USAGE UsageMin, UsageMax;
+ USHORT StringMin, StringMax;
+ USHORT DesignatorMin, DesignatorMax;
+ USHORT DataIndexMin, DataIndexMax;
+ } Range;
+ struct {
+ USAGE Usage, Reserved1;
+ USHORT StringIndex, Reserved2;
+ USHORT DesignatorIndex, Reserved3;
+ USHORT DataIndex, Reserved4;
+ } NotRange;
+ };
+
+} HIDP_BUTTON_CAPS, *PHIDP_BUTTON_CAPS;
+
+
+typedef struct _HIDP_VALUE_CAPS
+{
+ USAGE UsagePage;
+ UCHAR ReportID;
+ BOOLEAN IsAlias;
+
+ USHORT BitField;
+ USHORT LinkCollection; // A unique internal index pointer
+
+ USAGE LinkUsage;
+ USAGE LinkUsagePage;
+
+ BOOLEAN IsRange;
+ BOOLEAN IsStringRange;
+ BOOLEAN IsDesignatorRange;
+ BOOLEAN IsAbsolute;
+
+ BOOLEAN HasNull; // Does this channel have a null report union
+ UCHAR Reserved;
+ USHORT BitSize; // How many bits are devoted to this value?
+
+ USHORT ReportCount; // See Note below. Usually set to 1.
+ USHORT Reserved2[5];
+
+ ULONG UnitsExp;
+ ULONG Units;
+
+ LONG LogicalMin, LogicalMax;
+ LONG PhysicalMin, PhysicalMax;
+
+ union {
+ struct {
+ USAGE UsageMin, UsageMax;
+ USHORT StringMin, StringMax;
+ USHORT DesignatorMin, DesignatorMax;
+ USHORT DataIndexMin, DataIndexMax;
+ } Range;
+
+ struct {
+ USAGE Usage, Reserved1;
+ USHORT StringIndex, Reserved2;
+ USHORT DesignatorIndex, Reserved3;
+ USHORT DataIndex, Reserved4;
+ } NotRange;
+ };
+} HIDP_VALUE_CAPS, *PHIDP_VALUE_CAPS;
+
+//
+// Notes:
+//
+// ReportCount: When a report descriptor declares an Input, Output, or
+// Feature main item with fewer usage declarations than the report count, then
+// the last usage applies to all remaining unspecified count in that main item.
+// (As an example you might have data that required many fields to describe,
+// possibly buffered bytes.) In this case, only one value cap structure is
+// allocated for these associtated fields, all with the same usage, and Report
+// Count reflects the number of fields involved. Normally ReportCount is 1.
+// To access all of the fields in such a value structure would require using
+// HidP_GetUsageValueArray and HidP_SetUsageValueArray. HidP_GetUsageValue/
+// HidP_SetScaledUsageValue will also work, however, these functions will only
+// work with the first field of the structure.
+//
+
+//
+// The link collection tree consists of an array of LINK_COLLECTION_NODES
+// where the index into this array is the same as the collection number.
+//
+// Given a collection A which contains a subcollection B, A is defined to be
+// the parent B, and B is defined to be the child.
+//
+// Given collections A, B, and C where B and C are children of A, and B was
+// encountered before C in the report descriptor, B is defined as a sibling of
+// C. (This implies, of course, that if B is a sibling of C, then C is NOT a
+// sibling of B).
+//
+// B is defined as the NextSibling of C if and only if there exists NO
+// child collection of A, call it D, such that B is a sibling of D and D
+// is a sibling of C.
+//
+// E is defined to be the FirstChild of A if and only if for all children of A,
+// F, that are not equivalent to E, F is a sibling of E.
+// (This implies, of course, that the does not exist a child of A, call it G,
+// where E is a sibling of G). In other words the first sibling is the last
+// link collection found in the list.
+//
+// In other words, if a collection B is defined within the definition of another
+// collection A, B becomes a child of A. All collections with the same parent
+// are considered siblings. The FirstChild of the parent collection, A, will be
+// last collection defined that has A as a parent. The order of sibling pointers
+// is similarly determined. When a collection B is defined, it becomes the
+// FirstChild of it's parent collection. The previously defined FirstChild of the
+// parent collection becomes the NextSibling of the new collection. As new
+// collections with the same parent are discovered, the chain of sibling is built.
+//
+// With that in mind, the following describes conclusively a data structure
+// that provides direct traversal up, down, and accross the link collection
+// tree.
+//
+//
+typedef struct _HIDP_LINK_COLLECTION_NODE
+{
+ USAGE LinkUsage;
+ USAGE LinkUsagePage;
+ USHORT Parent;
+ USHORT NumberOfChildren;
+ USHORT NextSibling;
+ USHORT FirstChild;
+ ULONG CollectionType: 8; // As defined in 6.2.2.6 of HID spec
+ ULONG IsAlias : 1; // This link node is an allias of the next link node.
+ ULONG Reserved: 23;
+ PVOID UserContext; // The user can hang his coat here.
+} HIDP_LINK_COLLECTION_NODE, *PHIDP_LINK_COLLECTION_NODE;
+
+//
+// When a link collection is described by a delimiter, alias link collection
+// nodes are created. (One for each usage within the delimiter).
+// The parser assigns each capability description listed above only one
+// link collection.
+//
+// If a control is defined within a collection defined by
+// delimited usages, then that control is said to be within multiple link
+// collections, one for each usage within the open and close delimiter tokens.
+// Such multiple link collecions are said to be aliases. The first N-1 such
+// collections, listed in the link collection node array, have their IsAlias
+// bit set. The last such link collection is the link collection index used
+// in the capabilities described above.
+// Clients wishing to set a control in an aliased collection, should walk the
+// collection array once for each time they see the IsAlias flag set, and use
+// the last link collection as the index for the below accessor functions.
+//
+// NB: if IsAlias is set, then NextSibling should be one more than the current
+// link collection node index.
+//
+
+typedef PUCHAR PHIDP_REPORT_DESCRIPTOR;
+typedef struct _HIDP_PREPARSED_DATA * PHIDP_PREPARSED_DATA;
+
+typedef struct _HIDP_CAPS
+{
+ USAGE Usage;
+ USAGE UsagePage;
+ USHORT InputReportByteLength;
+ USHORT OutputReportByteLength;
+ USHORT FeatureReportByteLength;
+ USHORT Reserved[17];
+
+ USHORT NumberLinkCollectionNodes;
+
+ USHORT NumberInputButtonCaps;
+ USHORT NumberInputValueCaps;
+ USHORT NumberInputDataIndices;
+
+ USHORT NumberOutputButtonCaps;
+ USHORT NumberOutputValueCaps;
+ USHORT NumberOutputDataIndices;
+
+ USHORT NumberFeatureButtonCaps;
+ USHORT NumberFeatureValueCaps;
+ USHORT NumberFeatureDataIndices;
+} HIDP_CAPS, *PHIDP_CAPS;
+
+typedef struct _HIDP_DATA
+{
+ USHORT DataIndex;
+ USHORT Reserved;
+ union {
+ ULONG RawValue; // for values
+ BOOLEAN On; // for buttons MUST BE TRUE for buttons.
+ };
+} HIDP_DATA, *PHIDP_DATA;
+//
+// The HIDP_DATA structure is used with HidP_GetData and HidP_SetData
+// functions.
+//
+// The parser contiguously assigns every control (button or value) in a hid
+// device a unique data index from zero to NumberXXXDataIndices -1 , inclusive.
+// This value is found in the HIDP_BUTTON_CAPS and HIDP_VALUE_CAPS structures.
+//
+// Most clients will find the Get/Set Buttons / Value accessor functions
+// sufficient to their needs, as they will allow the clients to access the
+// data known to them while ignoring the other controls.
+//
+// More complex clients, which actually read the Button / Value Caps, and which
+// do a value add service to these routines (EG Direct Input), will need to
+// access all the data in the device without interest in the individual usage
+// or link collection location. These are the clients that will find
+// HidP_Data useful.
+//
+
+typedef struct _HIDP_UNKNOWN_TOKEN
+{
+ UCHAR Token;
+ UCHAR Reserved[3];
+ ULONG BitField;
+} HIDP_UNKNOWN_TOKEN, *PHIDP_UNKNOWN_TOKEN;
+
+typedef struct _HIDP_EXTENDED_ATTRIBUTES
+{
+ UCHAR NumGlobalUnknowns;
+ UCHAR Reserved [3];
+ PHIDP_UNKNOWN_TOKEN GlobalUnknowns;
+ // ... Additional attributes
+ ULONG Data [1]; // variableLength DO NOT ACCESS THIS FIELD
+} HIDP_EXTENDED_ATTRIBUTES, *PHIDP_EXTENDED_ATTRIBUTES;
+
+__checkReturn
+__drv_maxIRQL(PASSIVE_LEVEL)
+NTSTATUS __stdcall
+HidP_GetCaps (
+ __in PHIDP_PREPARSED_DATA PreparsedData,
+ __out PHIDP_CAPS Capabilities
+ );
+/*++
+Routine Description:
+ Returns a list of capabilities of a given hid device as described by its
+ preparsed data.
+
+Arguments:
+ PreparsedData The preparsed data returned from HIDCLASS.
+ Capabilities a HIDP_CAPS structure
+
+Return Value:
+ HIDP_STATUS_SUCCESS
+ HIDP_STATUS_INVALID_PREPARSED_DATA
+--*/
+
+__checkReturn
+__drv_maxIRQL(DISPATCH_LEVEL)
+NTSTATUS __stdcall
+HidP_GetLinkCollectionNodes (
+ OUT PHIDP_LINK_COLLECTION_NODE LinkCollectionNodes,
+ __inout PULONG LinkCollectionNodesLength,
+ __in PHIDP_PREPARSED_DATA PreparsedData
+ );
+/*++
+Routine Description:
+ Return a list of PHIDP_LINK_COLLECTION_NODEs used to describe the link
+ collection tree of this hid device. See the above description of
+ struct _HIDP_LINK_COLLECTION_NODE.
+
+Arguments:
+ LinkCollectionNodes - a caller allocated array into which
+ HidP_GetLinkCollectionNodes will store the information
+
+ LinKCollectionNodesLength - the caller sets this value to the length of the
+ the array in terms of number of elements.
+ HidP_GetLinkCollectionNodes sets this value to the actual
+ number of elements set. The total number of nodes required to
+ describe this HID device can be found in the
+ NumberLinkCollectionNodes field in the HIDP_CAPS structure.
+
+--*/
+
+__checkReturn
+__drv_maxIRQL(PASSIVE_LEVEL)
+NTSTATUS __stdcall
+HidP_GetSpecificButtonCaps (
+ __in HIDP_REPORT_TYPE ReportType,
+ __in USAGE UsagePage, // Optional (0 => ignore)
+ __in USHORT LinkCollection, // Optional (0 => ignore)
+ __in USAGE Usage, // Optional (0 => ignore)
+ OUT PHIDP_BUTTON_CAPS ButtonCaps,
+ __inout PUSHORT ButtonCapsLength,
+ __in PHIDP_PREPARSED_DATA PreparsedData
+ );
+/*++
+Description:
+ HidP_GetButtonCaps returns all the buttons (binary values) that are a part
+ of the given report type for the Hid device represented by the given
+ preparsed data.
+
+Parameters:
+ ReportType One of HidP_Input, HidP_Output, or HidP_Feature.
+
+ UsagePage A usage page value used to limit the button caps returned to
+ those on a given usage page. If set to 0, this parameter is
+ ignored. Can be used with LinkCollection and Usage parameters
+ to further limit the number of button caps structures returned.
+
+ LinkCollection HIDP_LINK_COLLECTION node array index used to limit the
+ button caps returned to those buttons in a given link
+ collection. If set to 0, this parameter is
+ ignored. Can be used with UsagePage and Usage parameters
+ to further limit the number of button caps structures
+ returned.
+
+ Usage A usage value used to limit the button caps returned to those
+ with the specified usage value. If set to 0, this parameter
+ is ignored. Can be used with LinkCollection and UsagePage
+ parameters to further limit the number of button caps
+ structures returned.
+
+ ButtonCaps A _HIDP_BUTTON_CAPS array containing information about all the
+ binary values in the given report. This buffer is provided by
+ the caller.
+
+ ButtonLength As input, this parameter specifies the length of the
+ ButtonCaps parameter (array) in number of array elements.
+ As output, this value is set to indicate how many of those
+ array elements were filled in by the function. The maximum number of
+ button caps that can be returned is found in the HIDP_CAPS
+ structure. If HIDP_STATUS_BUFFER_TOO_SMALL is returned,
+ this value contains the number of array elements needed to
+ successfully complete the request.
+
+ PreparsedData The preparsed data returned from HIDCLASS.
+
+
+Return Value
+HidP_GetSpecificButtonCaps returns the following error codes:
+ HIDP_STATUS_SUCCESS.
+ HIDP_STATUS_INVALID_REPORT_TYPE
+ HIDP_STATUS_INVALID_PREPARSED_DATA
+ HIDP_STATUS_BUFFER_TOO_SMALL (all given entries however have been filled in)
+ HIDP_STATUS_USAGE_NOT_FOUND
+--*/
+__checkReturn
+__drv_maxIRQL(PASSIVE_LEVEL)
+NTSTATUS __stdcall
+HidP_GetButtonCaps (
+ __in HIDP_REPORT_TYPE ReportType,
+ __out_ecount_part(*ButtonCapsLength, *ButtonCapsLength) PHIDP_BUTTON_CAPS ButtonCaps,
+ __inout PUSHORT ButtonCapsLength,
+ __in PHIDP_PREPARSED_DATA PreparsedData
+);
+
+__checkReturn
+__drv_maxIRQL(DISPATCH_LEVEL)
+NTSTATUS __stdcall
+HidP_GetSpecificValueCaps (
+ __in HIDP_REPORT_TYPE ReportType,
+ __in USAGE UsagePage, // Optional (0 => ignore)
+ __in USHORT LinkCollection, // Optional (0 => ignore)
+ __in USAGE Usage, // Optional (0 => ignore)
+ OUT PHIDP_VALUE_CAPS ValueCaps,
+ __inout PUSHORT ValueCapsLength,
+ __in PHIDP_PREPARSED_DATA PreparsedData
+ );
+/*++
+Description:
+ HidP_GetValueCaps returns all the values (non-binary) that are a part
+ of the given report type for the Hid device represented by the given
+ preparsed data.
+
+Parameters:
+ ReportType One of HidP_Input, HidP_Output, or HidP_Feature.
+
+ UsagePage A usage page value used to limit the value caps returned to
+ those on a given usage page. If set to 0, this parameter is
+ ignored. Can be used with LinkCollection and Usage parameters
+ to further limit the number of value caps structures returned.
+
+ LinkCollection HIDP_LINK_COLLECTION node array index used to limit the
+ value caps returned to those buttons in a given link
+ collection. If set to 0, this parameter is
+ ignored. Can be used with UsagePage and Usage parameters
+ to further limit the number of value caps structures
+ returned.
+
+ Usage A usage value used to limit the value caps returned to those
+ with the specified usage value. If set to 0, this parameter
+ is ignored. Can be used with LinkCollection and UsagePage
+ parameters to further limit the number of value caps
+ structures returned.
+
+ ValueCaps A _HIDP_VALUE_CAPS array containing information about all the
+ non-binary values in the given report. This buffer is provided
+ by the caller.
+
+ ValueLength As input, this parameter specifies the length of the ValueCaps
+ parameter (array) in number of array elements. As output,
+ this value is set to indicate how many of those array elements
+ were filled in by the function. The maximum number of
+ value caps that can be returned is found in the HIDP_CAPS
+ structure. If HIDP_STATUS_BUFFER_TOO_SMALL is returned,
+ this value contains the number of array elements needed to
+ successfully complete the request.
+
+ PreparsedData The preparsed data returned from HIDCLASS.
+
+
+Return Value
+HidP_GetValueCaps returns the following error codes:
+ HIDP_STATUS_SUCCESS.
+ HIDP_STATUS_INVALID_REPORT_TYPE
+ HIDP_STATUS_INVALID_PREPARSED_DATA
+ HIDP_STATUS_BUFFER_TOO_SMALL (all given entries however have been filled in)
+ HIDP_STATUS_USAGE_NOT_FOUND
+
+--*/
+
+__checkReturn
+__drv_maxIRQL(DISPATCH_LEVEL)
+NTSTATUS __stdcall
+HidP_GetValueCaps (
+ __in HIDP_REPORT_TYPE ReportType,
+ __out_ecount_part(*ValueCapsLength, *ValueCapsLength) PHIDP_VALUE_CAPS ValueCaps,
+ __inout PUSHORT ValueCapsLength,
+ __in PHIDP_PREPARSED_DATA PreparsedData
+);
+
+__checkReturn
+__drv_maxIRQL(DISPATCH_LEVEL)
+NTSTATUS __stdcall
+HidP_GetExtendedAttributes (
+ __in HIDP_REPORT_TYPE ReportType,
+ __in USHORT DataIndex,
+ __in PHIDP_PREPARSED_DATA PreparsedData,
+ __out_ecount_part(*LengthAttributes, *LengthAttributes) PHIDP_EXTENDED_ATTRIBUTES Attributes,
+ __inout PULONG LengthAttributes
+ );
+/*++
+Description:
+ Given a data index from the value or button capabilities of a given control
+ return any extended attributes for the control if any exist.
+
+Parameters:
+ ReportType One of HidP_Input, HidP_Output, or HidP_Feature.
+
+ DataIndex The data index for the given control, found in the capabilities
+ structure for that control
+
+ PreparsedData The preparsed data returned from HIDCLASS.
+
+ Attributes Pointer to a buffer into which the extended attribute data will
+ be copied.
+
+ LengthAttributes Length of the given buffer in bytes.
+
+Return Value
+ HIDP_STATUS_SUCCESS
+ HIDP_STATUS_DATA_INDEX_NOT_FOUND
+--*/
+
+__checkReturn
+__drv_maxIRQL(DISPATCH_LEVEL)
+NTSTATUS __stdcall
+HidP_InitializeReportForID (
+ __in HIDP_REPORT_TYPE ReportType,
+ __in UCHAR ReportID,
+ __in PHIDP_PREPARSED_DATA PreparsedData,
+ __out_bcount(ReportLength) PCHAR Report,
+ __in ULONG ReportLength
+ );
+/*++
+
+Routine Description:
+
+ Initialize a report based on the given report ID.
+
+Parameters:
+
+ ReportType One of HidP_Input, HidP_Output, or HidP_Feature.
+
+ PreparasedData Preparsed data structure returned by HIDCLASS
+
+ Report Buffer which to set the data into.
+
+ ReportLength Length of Report...Report should be at least as long as the
+ value indicated in the HIDP_CAPS structure for the device and
+ the corresponding ReportType
+
+Return Value
+
+ HIDP_STATUS_INVALID_REPORT_TYPE -- if ReportType is not valid.
+ HIDP_STATUS_INVALID_PREPARSED_DATA -- if PreparsedData is not valid
+ HIDP_STATUS_INVALID_REPORT_LENGTH -- the length of the report packet is not equal
+ to the length specified in HIDP_CAPS
+ structure for the given ReportType
+ HIDP_STATUS_REPORT_DOES_NOT_EXIST -- if there are no reports on this device
+ for the given ReportType
+
+--*/
+
+__checkReturn
+NTSTATUS __stdcall
+HidP_SetData (
+ __in HIDP_REPORT_TYPE ReportType,
+ __inout_ecount_part(*DataLength,*DataLength) PHIDP_DATA DataList,
+ __inout PULONG DataLength,
+ __in PHIDP_PREPARSED_DATA PreparsedData,
+ __in_bcount(ReportLength) PCHAR Report,
+ __in ULONG ReportLength
+ );
+/*++
+
+Routine Description:
+
+ Please Note: Since usage value arrays deal with multiple fields for
+ for one usage value, they cannot be used with HidP_SetData
+ and HidP_GetData. In this case,
+ HIDP_STATUS_IS_USAGE_VALUE_ARRAY will be returned.
+
+Parameters:
+
+ ReportType One of HidP_Input, HidP_Output, or HidP_Feature.
+
+ DataList Array of HIDP_DATA structures that contains the data values
+ that are to be set into the given report
+
+ DataLength As input, length in array elements of DataList. As output,
+ contains the number of data elements set on successful
+ completion or an index into the DataList array to identify
+ the faulting HIDP_DATA value if an error code is returned.
+
+ PreparasedData Preparsed data structure returned by HIDCLASS
+
+ Report Buffer which to set the data into.
+
+ ReportLength Length of Report...Report should be at least as long as the
+ value indicated in the HIDP_CAPS structure for the device and
+ the corresponding ReportType
+
+Return Value
+ HidP_SetData returns the following error codes. The report packet will
+ have all the data set up until the HIDP_DATA structure that caused the
+ error. DataLength, in the error case, will return this problem index.
+
+ HIDP_STATUS_SUCCESS -- upon successful insertion of all data
+ into the report packet.
+ HIDP_STATUS_INVALID_REPORT_TYPE -- if ReportType is not valid.
+ HIDP_STATUS_INVALID_PREPARSED_DATA -- if PreparsedData is not valid
+ HIDP_STATUS_DATA_INDEX_NOT_FOUND -- if a HIDP_DATA structure referenced a
+ data index that does not exist for this
+ device's ReportType
+ HIDP_STATUS_INVALID_REPORT_LENGTH -- the length of the report packet is not equal
+ to the length specified in HIDP_CAPS
+ structure for the given ReportType
+ HIDP_STATUS_REPORT_DOES_NOT_EXIST -- if there are no reports on this device
+ for the given ReportType
+ HIDP_STATUS_IS_USAGE_VALUE_ARRAY -- if one of the HIDP_DATA structures
+ references a usage value array.
+ DataLength will contain the index into
+ the array that was invalid
+ HIDP_STATUS_BUTTON_NOT_PRESSED -- if a HIDP_DATA structure attempted
+ to unset a button that was not already
+ set in the Report
+ HIDP_STATUS_INCOMPATIBLE_REPORT_ID -- a HIDP_DATA structure was found with
+ a valid index value but is contained
+ in a different report than the one
+ currently being processed
+ HIDP_STATUS_BUFFER_TOO_SMALL -- if there are not enough entries in
+ a given Main Array Item to report all
+ buttons that have been requested to be
+ set
+--*/
+
+__checkReturn
+__drv_maxIRQL(DISPATCH_LEVEL)
+NTSTATUS __stdcall
+HidP_GetData (
+ __in HIDP_REPORT_TYPE ReportType,
+ __out_ecount_part(*DataLength,*DataLength) PHIDP_DATA DataList,
+ __inout PULONG DataLength,
+ __in PHIDP_PREPARSED_DATA PreparsedData,
+ __out_bcount(ReportLength) PCHAR Report,
+ __in ULONG ReportLength
+ );
+/*++
+
+Routine Description:
+
+ Please Note: For obvious reasons HidP_SetData and HidP_GetData will not
+ access UsageValueArrays.
+
+Parameters:
+ ReportType One of HidP_Input, HidP_Output, or HidP_Feature.
+
+ DataList Array of HIDP_DATA structures that will receive the data
+ values that are set in the given report
+
+ DataLength As input, length in array elements of DataList. As output,
+ contains the number of data elements that were successfully
+ set by HidP_GetData. The maximum size necessary for DataList
+ can be determined by calling HidP_MaxDataListLength
+
+ PreparasedData Preparsed data structure returned by HIDCLASS
+
+ Report Buffer which to set the data into.
+
+ ReportLength Length of Report...Report should be at least as long as the
+ value indicated in the HIDP_CAPS structure for the device and
+ the corresponding ReportType
+
+Return Value
+ HidP_GetData returns the following error codes.
+
+ HIDP_STATUS_SUCCESS -- upon successful retrieval of all data
+ from the report packet.
+ HIDP_STATUS_INVALID_REPORT_TYPE -- if ReportType is not valid.
+ HIDP_STATUS_INVALID_PREPARSED_DATA -- if PreparsedData is not valid
+ HIDP_STATUS_INVALID_REPORT_LENGTH -- the length of the report packet is not equal
+ to the length specified in HIDP_CAPS
+ structure for the given ReportType
+ HIDP_STATUS_REPORT_DOES_NOT_EXIST -- if there are no reports on this device
+ for the given ReportType
+ HIDP_STATUS_BUFFER_TOO_SMALL -- if there are not enough array entries in
+ DataList to store all the indice values
+ in the given report. DataLength will
+ contain the number of array entries
+ required to hold all data
+--*/
+
+__drv_maxIRQL(DISPATCH_LEVEL)
+ULONG __stdcall
+HidP_MaxDataListLength (
+ __in HIDP_REPORT_TYPE ReportType,
+ __in PHIDP_PREPARSED_DATA PreparsedData
+ );
+/*++
+Routine Description:
+
+ This function returns the maximum length of HIDP_DATA elements that
+ HidP_GetData could return for the given report type.
+
+Parameters:
+
+ ReportType One of HidP_Input, HidP_Output or HidP_Feature.
+
+ PreparsedData Preparsed data structure returned by HIDCLASS
+
+Return Value:
+
+ The length of the data list array required for the HidP_GetData function
+ call. If an error occurs (either HIDP_STATUS_INVALID_REPORT_TYPE or
+ HIDP_STATUS_INVALID_PREPARSED_DATA), this function returns 0.
+
+--*/
+
+#define HidP_SetButtons(Rty, Up, Lco, ULi, ULe, Ppd, Rep, Rle) \
+ HidP_SetUsages(Rty, Up, Lco, ULi, ULe, Ppd, Rep, Rle)
+
+__checkReturn
+NTSTATUS __stdcall
+HidP_SetUsages (
+ __in HIDP_REPORT_TYPE ReportType,
+ __in USAGE UsagePage,
+ __in USHORT LinkCollection,
+ __inout_ecount_part(*UsageLength,*UsageLength) PUSAGE UsageList,
+ __inout PULONG UsageLength,
+ __in PHIDP_PREPARSED_DATA PreparsedData,
+ __in_bcount(ReportLength) PCHAR Report,
+ __in ULONG ReportLength
+ );
+/*++
+
+Routine Description:
+ This function sets binary values (buttons) in a report. Given an
+ initialized packet of correct length, it modifies the report packet so that
+ each element in the given list of usages has been set in the report packet.
+ For example, in an output report with 5 LED's, each with a given usage,
+ an application could turn on any subset of these lights by placing their
+ usages in any order into the usage array (UsageList). HidP_SetUsages would,
+ in turn, set the appropriate bit or add the corresponding byte into the
+ HID Main Array Item.
+
+ A properly initialized Report packet is one of the correct byte length,
+ and all zeros.
+
+ NOTE: A packet that has already been set with a call to a HidP_Set routine
+ can also be passed in. This routine then sets processes the UsageList
+ in the same fashion but verifies that the ReportID already set in
+ Report matches the report ID for the given usages.
+
+Parameters:
+ ReportType One of HidP_Input, HidP_Output or HidP_Feature.
+
+ UsagePage All of the usages in the usage array, which HidP_SetUsages will
+ set in the report, refer to this same usage page.
+ If a client wishes to set usages in a report for multiple
+ usage pages then that client needs to make multiple calls to
+ HidP_SetUsages for each of the usage pages.
+
+ UsageList A usage array containing the usages that HidP_SetUsages will set in
+ the report packet.
+
+ UsageLength The length of the given usage array in array elements.
+ The parser will set this value to the position in the usage
+ array where it stopped processing. If successful, UsageLength
+ will be unchanged. In any error condition, this parameter
+ reflects how many of the usages in the usage list have
+ actually been set by the parser. This is useful for finding
+ the usage in the list which caused the error.
+
+ PreparsedData The preparsed data recevied from HIDCLASS
+
+ Report The report packet.
+
+ ReportLength Length of the given report packet...Must be equal to the
+ value reported in the HIDP_CAPS structure for the device
+ and corresponding report type.
+
+Return Value
+ HidP_SetUsages returns the following error codes. On error, the report packet
+ will be correct up until the usage element that caused the error.
+
+ HIDP_STATUS_SUCCESS -- upon successful insertion of all usages
+ into the report packet.
+ HIDP_STATUS_INVALID_REPORT_TYPE -- if ReportType is not valid.
+ HIDP_STATUS_INVALID_PREPARSED_DATA -- if PreparsedData is not valid
+ HIDP_STATUS_INVALID_REPORT_LENGTH -- the length of the report packet is not
+ equal to the length specified in
+ the HIDP_CAPS structure for the given
+ ReportType
+ HIDP_STATUS_REPORT_DOES_NOT_EXIST -- if there are no reports on this device
+ for the given ReportType
+ HIDP_STATUS_INCOMPATIBLE_REPORT_ID -- if a usage was found that exists in a
+ different report. If the report is
+ zero-initialized on entry the first
+ usage in the list will determine which
+ report ID is used. Otherwise, the
+ parser will verify that usage matches
+ the passed in report's ID
+ HIDP_STATUS_USAGE_NOT_FOUND -- if the usage does not exist for any
+ report (no matter what the report ID)
+ for the given report type.
+ HIDP_STATUS_BUFFER_TOO_SMALL -- if there are not enough entries in a
+ given Main Array Item to list all of
+ the given usages. The caller needs
+ to split his request into more than
+ one call
+--*/
+
+#define HidP_UnsetButtons(Rty, Up, Lco, ULi, ULe, Ppd, Rep, Rle) \
+ HidP_UnsetUsages(Rty, Up, Lco, ULi, ULe, Ppd, Rep, Rle)
+
+__checkReturn
+NTSTATUS __stdcall
+HidP_UnsetUsages (
+ __in HIDP_REPORT_TYPE ReportType,
+ __in USAGE UsagePage,
+ __in_opt USHORT LinkCollection,
+ __inout_ecount_part(*UsageLength,*UsageLength) PUSAGE UsageList,
+ __inout PULONG UsageLength,
+ __in PHIDP_PREPARSED_DATA PreparsedData,
+ __in_bcount(ReportLength) PCHAR Report,
+ __in ULONG ReportLength
+ );
+/*++
+
+Routine Description:
+ This function unsets (turns off) binary values (buttons) in the report. Given
+ an initialized packet of correct length, it modifies the report packet so
+ that each element in the given list of usages has been unset in the
+ report packet.
+
+ This function is the "undo" operation for SetUsages. If the given usage
+ is not already set in the Report, it will return an error code of
+ HIDP_STATUS_BUTTON_NOT_PRESSED. If the button is pressed, HidP_UnsetUsages
+ will unset the appropriate bit or remove the corresponding index value from
+ the HID Main Array Item.
+
+ A properly initialized Report packet is one of the correct byte length,
+ and all zeros..
+
+ NOTE: A packet that has already been set with a call to a HidP_Set routine
+ can also be passed in. This routine then processes the UsageList
+ in the same fashion but verifies that the ReportID already set in
+ Report matches the report ID for the given usages.
+
+Parameters:
+ ReportType One of HidP_Input, HidP_Output or HidP_Feature.
+
+ UsagePage All of the usages in the usage array, which HidP_UnsetUsages will
+ unset in the report, refer to this same usage page.
+ If a client wishes to unset usages in a report for multiple
+ usage pages then that client needs to make multiple calls to
+ HidP_UnsetUsages for each of the usage pages.
+
+ UsageList A usage array containing the usages that HidP_UnsetUsages will
+ unset in the report packet.
+
+ UsageLength The length of the given usage array in array elements.
+ The parser will set this value to the position in the usage
+ array where it stopped processing. If successful, UsageLength
+ will be unchanged. In any error condition, this parameter
+ reflects how many of the usages in the usage list have
+ actually been unset by the parser. This is useful for finding
+ the usage in the list which caused the error.
+
+ PreparsedData The preparsed data recevied from HIDCLASS
+
+ Report The report packet.
+
+ ReportLength Length of the given report packet...Must be equal to the
+ value reported in the HIDP_CAPS structure for the device
+ and corresponding report type.
+
+Return Value
+ HidP_UnsetUsages returns the following error codes. On error, the report
+ packet will be correct up until the usage element that caused the error.
+
+ HIDP_STATUS_SUCCESS -- upon successful "unsetting" of all usages
+ in the report packet.
+ HIDP_STATUS_INVALID_REPORT_TYPE -- if ReportType is not valid.
+ HIDP_STATUS_INVALID_PREPARSED_DATA -- if PreparsedData is not valid
+ HIDP_STATUS_INVALID_REPORT_LENGTH -- the length of the report packet is not
+ equal to the length specified in
+ the HIDP_CAPS structure for the given
+ ReportType
+ HIDP_STATUS_REPORT_DOES_NOT_EXIST -- if there are no reports on this device
+ for the given ReportType
+ HIDP_STATUS_INCOMPATIBLE_REPORT_ID -- if a usage was found that exists in a
+ different report. If the report is
+ zero-initialized on entry the first
+ usage in the list will determine which
+ report ID is used. Otherwise, the
+ parser will verify that usage matches
+ the passed in report's ID
+ HIDP_STATUS_USAGE_NOT_FOUND -- if the usage does not exist for any
+ report (no matter what the report ID)
+ for the given report type.
+ HIDP_STATUS_BUTTON_NOT_PRESSED -- if a usage corresponds to a button that
+ is not already set in the given report
+--*/
+
+#define HidP_GetButtons(Rty, UPa, LCo, ULi, ULe, Ppd, Rep, RLe) \
+ HidP_GetUsages(Rty, UPa, LCo, ULi, ULe, Ppd, Rep, RLe)
+
+__checkReturn
+NTSTATUS __stdcall
+HidP_GetUsages (
+ __in HIDP_REPORT_TYPE ReportType,
+ __in USAGE UsagePage,
+ __in USHORT LinkCollection,
+ __out_ecount(UsageLength) PUSAGE UsageList,
+ __inout PULONG UsageLength,
+ __in PHIDP_PREPARSED_DATA PreparsedData,
+ __out_bcount(ReportLength) PCHAR Report,
+ __in ULONG ReportLength
+ );
+/*++
+
+Routine Description:
+ This function returns the binary values (buttons) that are set in a HID
+ report. Given a report packet of correct length, it searches the report
+ packet for each usage for the given usage page and returns them in the
+ usage list.
+
+Parameters:
+ ReportType One of HidP_Input, HidP_Output or HidP_Feature.
+
+ UsagePage All of the usages in the usage list, which HidP_GetUsages will
+ retrieve in the report, refer to this same usage page.
+ If the client wishes to get usages in a packet for multiple
+ usage pages then that client needs to make multiple calls
+ to HidP_GetUsages.
+
+ LinkCollection An optional value which can limit which usages are returned
+ in the UsageList to those usages that exist in a specific
+ LinkCollection. A non-zero value indicates the index into
+ the HIDP_LINK_COLLECITON_NODE list returned by
+ HidP_GetLinkCollectionNodes of the link collection the
+ usage should belong to. A value of 0 indicates this
+ should value be ignored.
+
+ UsageList The usage array that will contain all the usages found in
+ the report packet.
+
+ UsageLength The length of the given usage array in array elements.
+ On input, this value describes the length of the usage list.
+ On output, HidP_GetUsages sets this value to the number of
+ usages that was found. Use HidP_MaxUsageListLength to
+ determine the maximum length needed to return all the usages
+ that a given report packet may contain.
+
+ PreparsedData Preparsed data structure returned by HIDCLASS
+
+ Report The report packet.
+
+ ReportLength Length (in bytes) of the given report packet
+
+
+Return Value
+ HidP_GetUsages returns the following error codes:
+
+ HIDP_STATUS_SUCCESS -- upon successfully retrieving all the
+ usages from the report packet
+ HIDP_STATUS_INVALID_REPORT_TYPE -- if ReportType is not valid.
+ HIDP_STATUS_INVALID_PREPARSED_DATA -- if PreparsedData is not valid
+ HIDP_STATUS_INVALID_REPORT_LENGTH -- the length of the report packet is not
+ equal to the length specified in
+ the HIDP_CAPS structure for the given
+ ReportType
+ HIDP_STATUS_REPORT_DOES_NOT_EXIST -- if there are no reports on this device
+ for the given ReportType
+ HIDP_STATUS_BUFFER_TOO_SMALL -- if the UsageList is not big enough to
+ hold all the usages found in the report
+ packet. If this is returned, the buffer
+ will contain UsageLength number of
+ usages. Use HidP_MaxUsageListLength to
+ find the maximum length needed
+ HIDP_STATUS_INCOMPATIBLE_REPORT_ID -- if no usages were found but usages
+ that match the UsagePage and
+ LinkCollection specified could be found
+ in a report with a different report ID
+ HIDP_STATUS_USAGE_NOT_FOUND -- if there are no usages in a reports for
+ the device and ReportType that match the
+ UsagePage and LinkCollection that were
+ specified
+--*/
+
+#define HidP_GetButtonsEx(Rty, LCo, BLi, ULe, Ppd, Rep, RLe) \
+ HidP_GetUsagesEx(Rty, LCo, BLi, ULe, Ppd, Rep, RLe)
+
+__checkReturn
+__drv_maxIRQL(DISPATCH_LEVEL)
+NTSTATUS __stdcall
+HidP_GetUsagesEx (
+ __in HIDP_REPORT_TYPE ReportType,
+ __in USHORT LinkCollection, // Optional
+ __inout_ecount_part(*UsageLength,*UsageLength) PUSAGE_AND_PAGE ButtonList,
+ __inout ULONG * UsageLength,
+ __in PHIDP_PREPARSED_DATA PreparsedData,
+ __in_bcount(ReportLength) PCHAR Report,
+ __in ULONG ReportLength
+ );
+
+/*++
+
+Routine Description:
+ This function returns the binary values (buttons) in a HID report.
+ Given a report packet of correct length, it searches the report packet
+ for all buttons and returns the UsagePage and Usage for each of the buttons
+ it finds.
+
+Parameters:
+ ReportType One of HidP_Input, HidP_Output or HidP_Feature.
+
+ LinkCollection An optional value which can limit which usages are returned
+ in the ButtonList to those usages that exist in a specific
+ LinkCollection. A non-zero value indicates the index into
+ the HIDP_LINK_COLLECITON_NODE list returned by
+ HidP_GetLinkCollectionNodes of the link collection the
+ usage should belong to. A value of 0 indicates this
+ should value be ignored.
+
+ ButtonList An array of USAGE_AND_PAGE structures describing all the
+ buttons currently ``down'' in the device.
+
+ UsageLength The length of the given array in terms of elements.
+ On input, this value describes the length of the list. On
+ output, HidP_GetUsagesEx sets this value to the number of
+ usages that were found. Use HidP_MaxUsageListLength to
+ determine the maximum length needed to return all the usages
+ that a given report packet may contain.
+
+ PreparsedData Preparsed data returned by HIDCLASS
+
+ Report The report packet.
+
+ ReportLength Length (in bytes) of the given report packet.
+
+
+Return Value
+ HidP_GetUsagesEx returns the following error codes:
+
+ HIDP_STATUS_SUCCESS -- upon successfully retrieving all the
+ usages from the report packet
+ HIDP_STATUS_INVALID_REPORT_TYPE -- if ReportType is not valid.
+ HIDP_STATUS_INVALID_PREPARSED_DATA -- if PreparsedData is not valid
+ HIDP_STATUS_INVALID_REPORT_LENGTH -- the length of the report packet is not
+ equal to the length specified in
+ the HIDP_CAPS structure for the given
+ ReportType
+ HIDP_STATUS_REPORT_DOES_NOT_EXIST -- if there are no reports on this device
+ for the given ReportType
+ HIDP_STATUS_BUFFER_TOO_SMALL -- if ButtonList is not big enough to
+ hold all the usages found in the report
+ packet. If this is returned, the buffer
+ will contain UsageLength number of
+ usages. Use HidP_MaxUsageListLength to
+ find the maximum length needed
+ HIDP_STATUS_INCOMPATIBLE_REPORT_ID -- if no usages were found but usages
+ that match the specified LinkCollection
+ exist in report with a different report
+ ID.
+ HIDP_STATUS_USAGE_NOT_FOUND -- if there are no usages in any reports that
+ match the LinkCollection parameter
+--*/
+
+__drv_maxIRQL(PASSIVE_LEVEL)
+ULONG __stdcall
+HidP_MaxUsageListLength (
+ __in HIDP_REPORT_TYPE ReportType,
+ __in USAGE UsagePage, // Optional
+ __in PHIDP_PREPARSED_DATA PreparsedData
+ );
+/*++
+Routine Description:
+ This function returns the maximum number of usages that a call to
+ HidP_GetUsages or HidP_GetUsagesEx could return for a given HID report.
+ If calling for number of usages returned by HidP_GetUsagesEx, use 0 as
+ the UsagePage value.
+
+Parameters:
+ ReportType One of HidP_Input, HidP_Output or HidP_Feature.
+
+ UsagePage Specifies the optional UsagePage to query for. If 0, will
+ return all the maximum number of usage values that could be
+ returned for a given ReportType. If non-zero, will return
+ the maximum number of usages that would be returned for the
+ ReportType with the given UsagePage.
+
+ PreparsedData Preparsed data returned from HIDCLASS
+
+Return Value:
+ The length of the usage list array required for the HidP_GetUsages or
+ HidP_GetUsagesEx function call. If an error occurs (such as
+ HIDP_STATUS_INVALID_REPORT_TYPE or HIDP_INVALID_PREPARSED_DATA, this
+ returns 0.
+--*/
+
+__checkReturn
+NTSTATUS __stdcall
+HidP_SetUsageValue (
+ __in HIDP_REPORT_TYPE ReportType,
+ __in USAGE UsagePage,
+ __in USHORT LinkCollection,
+ __in USAGE Usage,
+ __in ULONG UsageValue,
+ __in PHIDP_PREPARSED_DATA PreparsedData,
+ __inout_bcount(ReportLength) PCHAR Report,
+ __in ULONG ReportLength
+ );
+/*++
+Description:
+ HidP_SetUsageValue inserts a value into the HID Report Packet in the field
+ corresponding to the given usage page and usage. HidP_SetUsageValue
+ casts this value to the appropriate bit length. If a report packet
+ contains two different fields with the same Usage and UsagePage,
+ they can be distinguished with the optional LinkCollection field value.
+ Using this function sets the raw value into the report packet with
+ no checking done as to whether it actually falls within the logical
+ minimum/logical maximum range. Use HidP_SetScaledUsageValue for this...
+
+ NOTE: Although the UsageValue parameter is a ULONG, any casting that is
+ done will preserve or sign-extend the value. The value being set
+ should be considered a LONG value and will be treated as such by
+ this function.
+
+Parameters:
+
+ ReportType One of HidP_Output or HidP_Feature.
+
+ UsagePage The usage page to which the given usage refers.
+
+ LinkCollection (Optional) This value can be used to differentiate
+ between two fields that may have the same
+ UsagePage and Usage but exist in different
+ collections. If the link collection value
+ is zero, this function will set the first field
+ it finds that matches the usage page and
+ usage.
+
+ Usage The usage whose value HidP_SetUsageValue will set.
+
+ UsageValue The raw value to set in the report buffer. This value must be within
+ the logical range or if a NULL value this value should be the
+ most negative value that can be represented by the number of bits
+ for this field.
+
+ PreparsedData The preparsed data returned for HIDCLASS
+
+ Report The report packet.
+
+ ReportLength Length (in bytes) of the given report packet.
+
+
+Return Value:
+ HidP_SetUsageValue returns the following error codes:
+
+ HIDP_STATUS_SUCCESS -- upon successfully setting the value
+ in the report packet
+ HIDP_STATUS_INVALID_REPORT_TYPE -- if ReportType is not valid.
+ HIDP_STATUS_INVALID_PREPARSED_DATA -- if PreparsedData is not valid
+ HIDP_STATUS_INVALID_REPORT_LENGTH -- the length of the report packet is not
+ equal to the length specified in
+ the HIDP_CAPS structure for the given
+ ReportType
+ HIDP_STATUS_REPORT_DOES_NOT_EXIST -- if there are no reports on this device
+ for the given ReportType
+ HIDP_STATUS_INCOMPATIBLE_REPORT_ID -- the specified usage page, usage and
+ link collection exist but exists in
+ a report with a different report ID
+ than the report being passed in. To
+ set this value, call HidP_SetUsageValue
+ again with a zero-initizialed report
+ packet
+ HIDP_STATUS_USAGE_NOT_FOUND -- if the usage page, usage, and link
+ collection combination does not exist
+ in any reports for this ReportType
+--*/
+__checkReturn
+NTSTATUS __stdcall
+HidP_SetScaledUsageValue (
+ __in HIDP_REPORT_TYPE ReportType,
+ __in USAGE UsagePage,
+ __in USHORT LinkCollection,
+ __in USAGE Usage,
+ __in LONG UsageValue,
+ __in PHIDP_PREPARSED_DATA PreparsedData,
+ __inout_bcount(ReportLength) PCHAR Report,
+ __in ULONG ReportLength
+ );
+
+/*++
+Description:
+ HidP_SetScaledUsageValue inserts the UsageValue into the HID report packet
+ in the field corresponding to the given usage page and usage. If a report
+ packet contains two different fields with the same Usage and UsagePage,
+ they can be distinguished with the optional LinkCollection field value.
+
+ If the specified field has a defined physical range, this function converts
+ the physical value specified to the corresponding logical value for the
+ report. If a physical value does not exist, the function will verify that
+ the value specified falls within the logical range and set according.
+
+ If the range checking fails but the field has NULL values, the function will
+ set the field to the defined NULL value (most negative number possible) and
+ return HIDP_STATUS_NULL. In other words, use this function to set NULL
+ values for a given field by passing in a value that falls outside the
+ physical range if it is defined or the logical range otherwise.
+
+ If the field does not support NULL values, an out of range error will be
+ returned instead.
+
+Parameters:
+
+ ReportType One of HidP_Output or HidP_Feature.
+
+ UsagePage The usage page to which the given usage refers.
+
+ LinkCollection (Optional) This value can be used to differentiate
+ between two fields that may have the same
+ UsagePage and Usage but exist in different
+ collections. If the link collection value
+ is zero, this function will set the first field
+ it finds that matches the usage page and
+ usage.
+
+ Usage The usage whose value HidP_SetScaledUsageValue will set.
+
+ UsageValue The value to set in the report buffer. See the routine
+ description above for the different interpretations of this
+ value
+
+ PreparsedData The preparsed data returned from HIDCLASS
+
+ Report The report packet.
+
+ ReportLength Length (in bytes) of the given report packet.
+
+
+Return Value:
+ HidP_SetScaledUsageValue returns the following error codes:
+
+ HIDP_STATUS_SUCCESS -- upon successfully setting the value
+ in the report packet
+ HIDP_STATUS_NULL -- upon successfully setting the value
+ in the report packet as a NULL value
+ HIDP_STATUS_INVALID_REPORT_TYPE -- if ReportType is not valid.
+ HIDP_STATUS_INVALID_PREPARSED_DATA -- if PreparsedData is not valid
+ HIDP_STATUS_INVALID_REPORT_LENGTH -- the length of the report packet is not
+ equal to the length specified in
+ the HIDP_CAPS structure for the given
+ ReportType
+ HIDP_STATUS_VALUE_OUT_OF_RANGE -- if the value specified failed to fall
+ within the physical range if it exists
+ or within the logical range otherwise
+ and the field specified by the usage
+ does not allow NULL values
+ HIDP_STATUS_BAD_LOG_PHY_VALUES -- if the field has a physical range but
+ either the logical range is invalid
+ (max <= min) or the physical range is
+ invalid
+ HIDP_STATUS_INCOMPATIBLE_REPORT_ID -- the specified usage page, usage and
+ link collection exist but exists in
+ a report with a different report ID
+ than the report being passed in. To
+ set this value, call
+ HidP_SetScaledUsageValue again with
+ a zero-initialized report packet
+ HIDP_STATUS_USAGE_NOT_FOUND -- if the usage page, usage, and link
+ collection combination does not exist
+ in any reports for this ReportType
+--*/
+__checkReturn
+NTSTATUS __stdcall
+HidP_SetUsageValueArray (
+ __in HIDP_REPORT_TYPE ReportType,
+ __in USAGE UsagePage,
+ __in USHORT LinkCollection,
+ __in USAGE Usage,
+ __in_bcount(UsageValueByteLength) PCHAR UsageValue,
+ __in USHORT UsageValueByteLength,
+ __in PHIDP_PREPARSED_DATA PreparsedData,
+ __inout_bcount(ReportLength) PCHAR Report,
+ __in ULONG ReportLength
+ );
+
+/*++
+Routine Descripton:
+ A usage value array occurs when the last usage in the list of usages
+ describing a main item must be repeated because there are less usages defined
+ than there are report counts declared for the given main item. In this case
+ a single value cap is allocated for that usage and the report count of that
+ value cap is set to reflect the number of fields to which that usage refers.
+
+ HidP_SetUsageValueArray sets the raw bits for that usage which spans
+ more than one field in a report.
+
+ NOTE: This function currently does not support value arrays where the
+ ReportSize for each of the fields in the array is not a multiple
+ of 8 bits.
+
+ The UsageValue buffer should have the values set as they would appear
+ in the report buffer. If this function supported non 8-bit multiples
+ for the ReportSize then caller should format the input buffer so that
+ each new value begins at the bit immediately following the last bit
+ of the previous value
+
+Parameters:
+
+ ReportType One of HidP_Output or HidP_Feature.
+
+ UsagePage The usage page to which the given usage refers.
+
+ LinkCollection (Optional) This value can be used to differentiate
+ between two fields that may have the same
+ UsagePage and Usage but exist in different
+ collections. If the link collection value
+ is zero, this function will set the first field
+ it finds that matches the usage page and
+ usage.
+
+ Usage The usage whose value array HidP_SetUsageValueArray will set.
+
+ UsageValue The buffer with the values to set into the value array.
+ The number of BITS required is found by multiplying the
+ BitSize and ReportCount fields of the Value Cap for this
+ control. The least significant bit of this control found in the
+ given report will be placed in the least significan bit location
+ of the array given (little-endian format), regardless of whether
+ or not the field is byte alligned or if the BitSize is a multiple
+ of sizeof (CHAR).
+
+ See the above note for current implementation limitations.
+
+ UsageValueByteLength Length of the UsageValue buffer (in bytes)
+
+ PreparsedData The preparsed data returned from HIDCLASS
+
+ Report The report packet.
+
+ ReportLength Length (in bytes) of the given report packet.
+
+
+Return Value:
+ HIDP_STATUS_SUCCESS -- upon successfully setting the value
+ array in the report packet
+ HIDP_STATUS_INVALID_REPORT_TYPE -- if ReportType is not valid.
+ HIDP_STATUS_INVALID_PREPARSED_DATA -- if PreparsedData is not valid
+ HIDP_STATUS_INVALID_REPORT_LENGTH -- the length of the report packet is not
+ equal to the length specified in
+ the HIDP_CAPS structure for the given
+ ReportType
+ HIDP_STATUS_REPORT_DOES_NOT_EXIST -- if there are no reports on this device
+ for the given ReportType
+ HIDP_STATUS_NOT_VALUE_ARRAY -- if the control specified is not a
+ value array -- a value array will have
+ a ReportCount field in the
+ HIDP_VALUE_CAPS structure that is > 1
+ Use HidP_SetUsageValue instead
+ HIDP_STATUS_BUFFER_TOO_SMALL -- if the size of the passed in buffer with
+ the values to set is too small (ie. has
+ fewer values than the number of fields in
+ the array
+ HIDP_STATUS_NOT_IMPLEMENTED -- if the usage value array has field sizes
+ that are not multiples of 8 bits, this
+ error code is returned since the function
+ currently does not handle setting into
+ such arrays.
+ HIDP_STATUS_INCOMPATIBLE_REPORT_ID -- the specified usage page, usage and
+ link collection exist but exists in
+ a report with a different report ID
+ than the report being passed in. To
+ set this value, call
+ HidP_SetUsageValueArray again with
+ a zero-initialized report packet
+ HIDP_STATUS_USAGE_NOT_FOUND -- if the usage page, usage, and link
+ collection combination does not exist
+ in any reports for this ReportType
+--*/
+
+__checkReturn
+NTSTATUS __stdcall
+HidP_GetUsageValue (
+ __in HIDP_REPORT_TYPE ReportType,
+ __in USAGE UsagePage,
+ __in USHORT LinkCollection,
+ __in USAGE Usage,
+ __out PULONG UsageValue,
+ __in PHIDP_PREPARSED_DATA PreparsedData,
+ __in_bcount(ReportLength) PCHAR Report,
+ __in ULONG ReportLength
+ );
+
+/*
+Description
+ HidP_GetUsageValue retrieves the value from the HID Report for the usage
+ specified by the combination of usage page, usage and link collection.
+ If a report packet contains two different fields with the same
+ Usage and UsagePage, they can be distinguished with the optional
+ LinkCollection field value.
+
+Parameters:
+
+ ReportType One of HidP_Input or HidP_Feature.
+
+ UsagePage The usage page to which the given usage refers.
+
+ LinkCollection (Optional) This value can be used to differentiate
+ between two fields that may have the same
+ UsagePage and Usage but exist in different
+ collections. If the link collection value
+ is zero, this function will set the first field
+ it finds that matches the usage page and
+ usage.
+
+ Usage The usage whose value HidP_GetUsageValue will retrieve
+
+ UsageValue The raw value that is set for the specified field in the report
+ buffer. This value will either fall within the logical range
+ or if NULL values are allowed, a number outside the range to
+ indicate a NULL
+
+ PreparsedData The preparsed data returned for HIDCLASS
+
+ Report The report packet.
+
+ ReportLength Length (in bytes) of the given report packet.
+
+
+Return Value:
+ HidP_GetUsageValue returns the following error codes:
+
+ HIDP_STATUS_SUCCESS -- upon successfully retrieving the value
+ from the report packet
+ HIDP_STATUS_INVALID_REPORT_TYPE -- if ReportType is not valid.
+ HIDP_STATUS_INVALID_PREPARSED_DATA -- if PreparsedData is not valid
+ HIDP_STATUS_INVALID_REPORT_LENGTH -- the length of the report packet is not
+ equal to the length specified in
+ the HIDP_CAPS structure for the given
+ ReportType
+ HIDP_STATUS_REPORT_DOES_NOT_EXIST -- if there are no reports on this device
+ for the given ReportType
+ HIDP_STATUS_INCOMPATIBLE_REPORT_ID -- the specified usage page, usage and
+ link collection exist but exists in
+ a report with a different report ID
+ than the report being passed in. To
+ set this value, call HidP_GetUsageValue
+ again with a different report packet
+ HIDP_STATUS_USAGE_NOT_FOUND -- if the usage page, usage, and link
+ collection combination does not exist
+ in any reports for this ReportType
+--*/
+
+__checkReturn
+NTSTATUS __stdcall
+HidP_GetScaledUsageValue (
+ __in HIDP_REPORT_TYPE ReportType,
+ __in USAGE UsagePage,
+ __in USHORT LinkCollection,
+ __in USAGE Usage,
+ __out PLONG UsageValue,
+ __in PHIDP_PREPARSED_DATA PreparsedData,
+ __in_bcount(ReportLength) PCHAR Report,
+ __in ULONG ReportLength
+ );
+
+/*++
+Description
+ HidP_GetScaledUsageValue retrieves a UsageValue from the HID report packet
+ in the field corresponding to the given usage page and usage. If a report
+ packet contains two different fields with the same Usage and UsagePage,
+ they can be distinguished with the optional LinkCollection field value.
+
+ If the specified field has a defined physical range, this function converts
+ the logical value that exists in the report packet to the corresponding
+ physical value. If a physical range does not exist, the function will
+ return the logical value. This function will check to verify that the
+ logical value in the report falls within the declared logical range.
+
+ When doing the conversion between logical and physical values, this
+ function assumes a linear extrapolation between the physical max/min and
+ the logical max/min. (Where logical is the values reported by the device
+ and physical is the value returned by this function). If the data field
+ size is less than 32 bits, then HidP_GetScaledUsageValue will sign extend
+ the value to 32 bits.
+
+ If the range checking fails but the field has NULL values, the function
+ will set UsageValue to 0 and return HIDP_STATUS_NULL. Otherwise, it
+ returns a HIDP_STATUS_OUT_OF_RANGE error.
+
+Parameters:
+
+ ReportType One of HidP_Output or HidP_Feature.
+
+ UsagePage The usage page to which the given usage refers.
+
+ LinkCollection (Optional) This value can be used to differentiate
+ between two fields that may have the same
+ UsagePage and Usage but exist in different
+ collections. If the link collection value
+ is zero, this function will retrieve the first
+ field it finds that matches the usage page
+ and usage.
+
+ Usage The usage whose value HidP_GetScaledUsageValue will retrieve
+
+ UsageValue The value retrieved from the report buffer. See the routine
+ description above for the different interpretations of this
+ value
+
+ PreparsedData The preparsed data returned from HIDCLASS
+
+ Report The report packet.
+
+ ReportLength Length (in bytes) of the given report packet.
+
+
+Return Value:
+ HidP_GetScaledUsageValue returns the following error codes:
+
+ HIDP_STATUS_SUCCESS -- upon successfully retrieving the value
+ from the report packet
+ HIDP_STATUS_NULL -- if the report packet had a NULL value
+ set
+ HIDP_STATUS_INVALID_REPORT_TYPE -- if ReportType is not valid.
+ HIDP_STATUS_INVALID_PREPARSED_DATA -- if PreparsedData is not valid
+ HIDP_STATUS_INVALID_REPORT_LENGTH -- the length of the report packet is not
+ equal to the length specified in
+ the HIDP_CAPS structure for the given
+ ReportType
+ HIDP_STATUS_VALUE_OUT_OF_RANGE -- if the value retrieved from the packet
+ falls outside the logical range and
+ the field does not support NULL values
+ HIDP_STATUS_BAD_LOG_PHY_VALUES -- if the field has a physical range but
+ either the logical range is invalid
+ (max <= min) or the physical range is
+ invalid
+ HIDP_STATUS_INCOMPATIBLE_REPORT_ID -- the specified usage page, usage and
+ link collection exist but exists in
+ a report with a different report ID
+ than the report being passed in. To
+ set this value, call
+ HidP_GetScaledUsageValue with a
+ different report packet
+ HIDP_STATUS_USAGE_NOT_FOUND -- if the usage page, usage, and link
+ collection combination does not exist
+ in any reports for this ReportType
+--*/
+__checkReturn
+NTSTATUS __stdcall
+HidP_GetUsageValueArray (
+ __in HIDP_REPORT_TYPE ReportType,
+ __in USAGE UsagePage,
+ __in USHORT LinkCollection,
+ __in USAGE Usage,
+ __inout_bcount(UsageValueByteLength) PCHAR UsageValue,
+ __in USHORT UsageValueByteLength,
+ __in PHIDP_PREPARSED_DATA PreparsedData,
+ __in_bcount(ReportLength) PCHAR Report,
+ __in ULONG ReportLength
+ );
+
+/*++
+Routine Descripton:
+ A usage value array occurs when the last usage in the list of usages
+ describing a main item must be repeated because there are less usages defined
+ than there are report counts declared for the given main item. In this case
+ a single value cap is allocated for that usage and the report count of that
+ value cap is set to reflect the number of fields to which that usage refers.
+
+ HidP_GetUsageValueArray returns the raw bits for that usage which spans
+ more than one field in a report.
+
+ NOTE: This function currently does not support value arrays where the
+ ReportSize for each of the fields in the array is not a multiple
+ of 8 bits.
+
+ The UsageValue buffer will have the raw values as they are set
+ in the report packet.
+
+Parameters:
+
+ ReportType One of HidP_Input, HidP_Output or HidP_Feature.
+
+ UsagePage The usage page to which the given usage refers.
+
+ LinkCollection (Optional) This value can be used to differentiate
+ between two fields that may have the same
+ UsagePage and Usage but exist in different
+ collections. If the link collection value
+ is zero, this function will set the first field
+ it finds that matches the usage page and
+ usage.
+
+ Usage The usage whose value HidP_GetUsageValueArray will retreive.
+
+ UsageValue A pointer to an array of characters where the value will be
+ placed. The number of BITS required is found by multiplying the
+ BitSize and ReportCount fields of the Value Cap for this
+ control. The least significant bit of this control found in the
+ given report will be placed in the least significant bit location
+ of the buffer (little-endian format), regardless of whether
+ or not the field is byte aligned or if the BitSize is a multiple
+ of sizeof (CHAR).
+
+ See note above about current implementation limitations
+
+ UsageValueByteLength
+ the length of the given UsageValue buffer.
+
+ PreparsedData The preparsed data returned by the HIDCLASS
+
+ Report The report packet.
+
+ ReportLength Length of the given report packet.
+
+Return Value:
+
+ HIDP_STATUS_SUCCESS -- upon successfully retrieving the value
+ from the report packet
+ HIDP_STATUS_INVALID_REPORT_TYPE -- if ReportType is not valid.
+ HIDP_STATUS_INVALID_PREPARSED_DATA -- if PreparsedData is not valid
+ HIDP_STATUS_INVALID_REPORT_LENGTH -- the length of the report packet is not
+ equal to the length specified in
+ the HIDP_CAPS structure for the given
+ ReportType
+ HIDP_STATUS_NOT_VALUE_ARRAY -- if the control specified is not a
+ value array -- a value array will have
+ a ReportCount field in the
+ HIDP_VALUE_CAPS structure that is > 1
+ Use HidP_GetUsageValue instead
+ HIDP_STATUS_BUFFER_TOO_SMALL -- if the size of the passed in buffer in
+ which to return the array is too small
+ (ie. has fewer values than the number of
+ fields in the array
+ HIDP_STATUS_NOT_IMPLEMENTED -- if the usage value array has field sizes
+ that are not multiples of 8 bits, this
+ error code is returned since the function
+ currently does not handle getting values
+ from such arrays.
+ HIDP_STATUS_INCOMPATIBLE_REPORT_ID -- the specified usage page, usage and
+ link collection exist but exists in
+ a report with a different report ID
+ than the report being passed in. To
+ set this value, call
+ HidP_GetUsageValueArray with a
+ different report packet
+ HIDP_STATUS_USAGE_NOT_FOUND -- if the usage page, usage, and link
+ collection combination does not exist
+ in any reports for this ReportType
+--*/
+
+__checkReturn
+__drv_maxIRQL(PASSIVE_LEVEL)
+NTSTATUS __stdcall
+HidP_UsageListDifference (
+ __in_ecount(UsageListLength) PUSAGE PreviousUsageList,
+ __in_ecount(UsageListLength) PUSAGE CurrentUsageList,
+ __out_ecount(UsageListLength) PUSAGE BreakUsageList,
+ __out_ecount(UsageListLength) PUSAGE MakeUsageList,
+ __in ULONG UsageListLength
+ );
+/*++
+Routine Description:
+ This function will return the difference between a two lists of usages
+ (as might be returned from HidP_GetUsages), In other words, it will return
+ return a list of usages that are in the current list but not the previous
+ list as well as a list of usages that are in the previous list but not
+ the current list.
+
+Parameters:
+
+ PreviousUsageList The list of usages before.
+ CurrentUsageList The list of usages now.
+ BreakUsageList Previous - Current.
+ MakeUsageList Current - Previous.
+ UsageListLength Represents the length of the usage lists in array
+ elements. If comparing two lists with a differing
+ number of array elements, this value should be
+ the size of the larger of the two lists. Any
+ zero found with a list indicates an early termination
+ of the list and any usages found after the first zero
+ will be ignored.
+--*/
+
+__checkReturn
+__drv_maxIRQL(PASSIVE_LEVEL)
+NTSTATUS __stdcall
+HidP_UsageAndPageListDifference (
+ __in_ecount(UsageListLength) PUSAGE_AND_PAGE PreviousUsageList,
+ __in_ecount(UsageListLength) PUSAGE_AND_PAGE CurrentUsageList,
+ __out_ecount(UsageListLength) PUSAGE_AND_PAGE BreakUsageList,
+ __out_ecount(UsageListLength) PUSAGE_AND_PAGE MakeUsageList,
+ __in ULONG UsageListLength
+ );
+
+//
+// Produce Make or Break Codes
+//
+typedef enum _HIDP_KEYBOARD_DIRECTION {
+ HidP_Keyboard_Break,
+ HidP_Keyboard_Make
+} HIDP_KEYBOARD_DIRECTION;
+
+//
+// A bitmap of the current shift state of the keyboard when using the
+// below keyboard usages to i8042 translation function.
+//
+typedef struct _HIDP_KEYBOARD_MODIFIER_STATE {
+ union {
+ struct {
+ ULONG LeftControl: 1;
+ ULONG LeftShift: 1;
+ ULONG LeftAlt: 1;
+ ULONG LeftGUI: 1;
+ ULONG RightControl: 1;
+ ULONG RightShift: 1;
+ ULONG RightAlt: 1;
+ ULONG RigthGUI: 1;
+ ULONG CapsLock: 1;
+ ULONG ScollLock: 1;
+ ULONG NumLock: 1;
+ ULONG Reserved: 21;
+ };
+ ULONG ul;
+ };
+
+} HIDP_KEYBOARD_MODIFIER_STATE, * PHIDP_KEYBOARD_MODIFIER_STATE;
+
+//
+// A call back function to give the i8042 scan codes to the caller of
+// the below translation function.
+//
+typedef BOOLEAN (* PHIDP_INSERT_SCANCODES) (
+ __in_opt PVOID Context, // Some caller supplied context.
+ __in_bcount(Length) PCHAR NewScanCodes, // A list of i8042 scan codes.
+ __in ULONG Length // the length of the scan codes.
+ );
+
+__checkReturn
+NTSTATUS __stdcall
+HidP_TranslateUsageAndPagesToI8042ScanCodes (
+ __in_ecount(UsageListLength) PUSAGE_AND_PAGE ChangedUsageList,
+ __in ULONG UsageListLength,
+ __in HIDP_KEYBOARD_DIRECTION KeyAction,
+ __inout PHIDP_KEYBOARD_MODIFIER_STATE ModifierState,
+ __in PHIDP_INSERT_SCANCODES InsertCodesProcedure,
+ __in_opt PVOID InsertCodesContext
+ );
+/*++
+Routine Description:
+Parameters:
+--*/
+__checkReturn
+NTSTATUS __stdcall
+HidP_TranslateUsagesToI8042ScanCodes (
+ __in_ecount(UsageListLength) PUSAGE ChangedUsageList,
+ __in ULONG UsageListLength,
+ __in HIDP_KEYBOARD_DIRECTION KeyAction,
+ __inout PHIDP_KEYBOARD_MODIFIER_STATE ModifierState,
+ __in PHIDP_INSERT_SCANCODES InsertCodesProcedure,
+ __in_opt PVOID InsertCodesContext
+ );
+/*++
+Routine Description:
+Parameters:
+--*/
+
+
+
+//
+// Define NT Status codes with Facility Code of FACILITY_HID_ERROR_CODE
+//
+
+// FACILITY_HID_ERROR_CODE defined in ntstatus.h
+#ifndef FACILITY_HID_ERROR_CODE
+#define FACILITY_HID_ERROR_CODE 0x11
+#endif
+
+#define HIDP_ERROR_CODES(SEV, CODE) \
+ ((NTSTATUS) (((SEV) << 28) | (FACILITY_HID_ERROR_CODE << 16) | (CODE)))
+
+#define HIDP_STATUS_SUCCESS (HIDP_ERROR_CODES(0x0,0))
+#define HIDP_STATUS_NULL (HIDP_ERROR_CODES(0x8,1))
+#define HIDP_STATUS_INVALID_PREPARSED_DATA (HIDP_ERROR_CODES(0xC,1))
+#define HIDP_STATUS_INVALID_REPORT_TYPE (HIDP_ERROR_CODES(0xC,2))
+#define HIDP_STATUS_INVALID_REPORT_LENGTH (HIDP_ERROR_CODES(0xC,3))
+#define HIDP_STATUS_USAGE_NOT_FOUND (HIDP_ERROR_CODES(0xC,4))
+#define HIDP_STATUS_VALUE_OUT_OF_RANGE (HIDP_ERROR_CODES(0xC,5))
+#define HIDP_STATUS_BAD_LOG_PHY_VALUES (HIDP_ERROR_CODES(0xC,6))
+#define HIDP_STATUS_BUFFER_TOO_SMALL (HIDP_ERROR_CODES(0xC,7))
+#define HIDP_STATUS_INTERNAL_ERROR (HIDP_ERROR_CODES(0xC,8))
+#define HIDP_STATUS_I8042_TRANS_UNKNOWN (HIDP_ERROR_CODES(0xC,9))
+#define HIDP_STATUS_INCOMPATIBLE_REPORT_ID (HIDP_ERROR_CODES(0xC,0xA))
+#define HIDP_STATUS_NOT_VALUE_ARRAY (HIDP_ERROR_CODES(0xC,0xB))
+#define HIDP_STATUS_IS_VALUE_ARRAY (HIDP_ERROR_CODES(0xC,0xC))
+#define HIDP_STATUS_DATA_INDEX_NOT_FOUND (HIDP_ERROR_CODES(0xC,0xD))
+#define HIDP_STATUS_DATA_INDEX_OUT_OF_RANGE (HIDP_ERROR_CODES(0xC,0xE))
+#define HIDP_STATUS_BUTTON_NOT_PRESSED (HIDP_ERROR_CODES(0xC,0xF))
+#define HIDP_STATUS_REPORT_DOES_NOT_EXIST (HIDP_ERROR_CODES(0xC,0x10))
+#define HIDP_STATUS_NOT_IMPLEMENTED (HIDP_ERROR_CODES(0xC,0x20))
+
+//
+// We blundered this status code.
+//
+#define HIDP_STATUS_I8242_TRANS_UNKNOWN HIDP_STATUS_I8042_TRANS_UNKNOWN
+
+#include
+
+#if _MSC_VER >= 1200
+#pragma warning(pop)
+#else
+#pragma warning(default:4115)
+#pragma warning(default:4201)
+#pragma warning(default:4214)
+#endif
+
+#endif
+
diff --git a/setupapi-x64/hidsdi.h b/setupapi-x64/hidsdi.h
new file mode 100644
index 0000000..8f97d75
--- /dev/null
+++ b/setupapi-x64/hidsdi.h
@@ -0,0 +1,494 @@
+/*++
+
+Copyright (c) Microsoft Corporation. All rights reserved.
+
+Module Name:
+
+ HIDSDI.H
+
+Abstract:
+
+ This module contains the PUBLIC definitions for the
+ code that implements the HID dll.
+
+Environment:
+
+ Kernel & user mode
+
+--*/
+
+
+#ifndef _HIDSDI_H
+#define _HIDSDI_H
+
+#include
+
+//#include "wtypes.h"
+
+//#include
+//#include
+//#include
+
+typedef LONG NTSTATUS;
+#include "hidusage.h"
+#include "hidpi.h"
+
+typedef struct _HIDD_CONFIGURATION {
+ PVOID cookie;
+ ULONG size;
+ ULONG RingBufferSize;
+} HIDD_CONFIGURATION, *PHIDD_CONFIGURATION;
+
+typedef struct _HIDD_ATTRIBUTES {
+ ULONG Size; // = sizeof (struct _HIDD_ATTRIBUTES)
+
+ //
+ // Vendor ids of this hid device
+ //
+ USHORT VendorID;
+ USHORT ProductID;
+ USHORT VersionNumber;
+
+ //
+ // Additional fields will be added to the end of this structure.
+ //
+} HIDD_ATTRIBUTES, *PHIDD_ATTRIBUTES;
+
+__checkReturn
+BOOLEAN __stdcall
+HidD_GetAttributes (
+ __in HANDLE HidDeviceObject,
+ __out PHIDD_ATTRIBUTES Attributes
+ );
+/*++
+Routine Description:
+ Fill in the given HIDD_ATTRIBUTES structure with the attributes of the
+ given hid device.
+
+--*/
+
+
+void __stdcall
+HidD_GetHidGuid (
+ __out LPGUID HidGuid
+ );
+
+__checkReturn
+BOOLEAN __stdcall
+HidD_GetPreparsedData (
+ __in HANDLE HidDeviceObject,
+ __out __drv_when(return!=0, __drv_allocatesMem(Mem)) PHIDP_PREPARSED_DATA * PreparsedData
+ );
+/*++
+Routine Description:
+ Given a handle to a valid Hid Class Device Object, retrieve the preparsed
+ data for the device. This routine will allocate the appropriately
+ sized buffer to hold this preparsed data. It is up to client to call
+ HidP_FreePreparsedData to free the memory allocated to this structure when
+ it is no longer needed.
+
+Arguments:
+ HidDeviceObject A handle to a Hid Device that the client obtains using
+ a call to CreateFile on a valid Hid device string name.
+ The string name can be obtained using standard PnP calls.
+
+ PreparsedData An opaque data structure used by other functions in this
+ library to retrieve information about a given device.
+
+Return Value:
+ TRUE if successful.
+ FALSE otherwise -- Use GetLastError() to get extended error information
+--*/
+BOOLEAN __stdcall
+HidD_FreePreparsedData (
+ __in __drv_freesMem(Mem) PHIDP_PREPARSED_DATA PreparsedData
+ );
+
+BOOLEAN __stdcall
+HidD_FlushQueue (
+ __in HANDLE HidDeviceObject
+ );
+/*++
+Routine Description:
+ Flush the input queue for the given HID device.
+
+Arguments:
+ HidDeviceObject A handle to a Hid Device that the client obtains using
+ a call to CreateFile on a valid Hid device string name.
+ The string name can be obtained using standard PnP calls.
+
+Return Value:
+ TRUE if successful
+ FALSE otherwise -- Use GetLastError() to get extended error information
+--*/
+__checkReturn
+BOOLEAN __stdcall
+HidD_GetConfiguration (
+ __in HANDLE HidDeviceObject,
+ __out_bcount(ConfigurationLength) PHIDD_CONFIGURATION Configuration,
+ __in ULONG ConfigurationLength
+ );
+/*++
+Routine Description:
+ Get the configuration information for this Hid device
+
+Arguments:
+ HidDeviceObject A handle to a Hid Device Object.
+
+ Configuration A configuration structure. HidD_GetConfiguration MUST
+ be called before the configuration can be modified and
+ set using HidD_SetConfiguration
+
+ ConfigurationLength That is ``sizeof (HIDD_CONFIGURATION)''. Using this
+ parameter, we can later increase the length of the
+ configuration array and not break older apps.
+
+Return Value:
+ TRUE if successful
+ FALSE otherwise -- Use GetLastError() to get extended error information
+--*/
+__checkReturn
+BOOLEAN __stdcall
+HidD_SetConfiguration (
+ __in HANDLE HidDeviceObject,
+ __in_bcount(ConfigurationLength) PHIDD_CONFIGURATION Configuration,
+ __in ULONG ConfigurationLength
+ );
+/*++
+Routine Description:
+ Set the configuration information for this Hid device...
+
+ NOTE: HidD_GetConfiguration must be called to retrieve the current
+ configuration information before this information can be modified
+ and set.
+
+Arguments:
+ HidDeviceObject A handle to a Hid Device Object.
+
+ Configuration A configuration structure. HidD_GetConfiguration MUST
+ be called before the configuration can be modified and
+ set using HidD_SetConfiguration
+
+ ConfigurationLength That is ``sizeof (HIDD_CONFIGURATION)''. Using this
+ parameter, we can later increase the length of the
+ configuration array and not break older apps.
+
+Return Value:
+ TRUE if successful
+ FALSE otherwise -- Use GetLastError() to get extended error information
+--*/
+__checkReturn
+BOOLEAN __stdcall
+HidD_GetFeature (
+ __in HANDLE HidDeviceObject,
+ __out_bcount(ReportBufferLength) PVOID ReportBuffer,
+ __in ULONG ReportBufferLength
+ );
+/*++
+Routine Description:
+ Retrieve a feature report from a HID device.
+
+Arguments:
+ HidDeviceObject A handle to a Hid Device Object.
+
+ ReportBuffer The buffer that the feature report should be placed
+ into. The first byte of the buffer should be set to
+ the report ID of the desired report
+
+ ReportBufferLength The size (in bytes) of ReportBuffer. This value
+ should be greater than or equal to the
+ FeatureReportByteLength field as specified in the
+ HIDP_CAPS structure for the device
+Return Value:
+ TRUE if successful
+ FALSE otherwise -- Use GetLastError() to get extended error information
+--*/
+__checkReturn
+BOOLEAN __stdcall
+HidD_SetFeature (
+ __in HANDLE HidDeviceObject,
+ __in_bcount(ReportBufferLength) PVOID ReportBuffer,
+ __in ULONG ReportBufferLength
+ );
+/*++
+Routine Description:
+ Send a feature report to a HID device.
+
+Arguments:
+ HidDeviceObject A handle to a Hid Device Object.
+
+ ReportBuffer The buffer of the feature report to send to the device
+
+ ReportBufferLength The size (in bytes) of ReportBuffer. This value
+ should be greater than or equal to the
+ FeatureReportByteLength field as specified in the
+ HIDP_CAPS structure for the device
+Return Value:
+ TRUE if successful
+ FALSE otherwise -- Use GetLastError() to get extended error information
+--*/
+
+#if (NTDDI_VERSION >= NTDDI_WINXP)
+__checkReturn
+BOOLEAN __stdcall
+HidD_GetInputReport (
+ __in HANDLE HidDeviceObject,
+ __out_bcount(ReportBufferLength) PVOID ReportBuffer,
+ __in ULONG ReportBufferLength
+ );
+/*++
+Routine Description:
+ Retrieve an input report from a HID device.
+
+Arguments:
+ HidDeviceObject A handle to a Hid Device Object.
+
+ ReportBuffer The buffer that the input report should be placed
+ into. The first byte of the buffer should be set to
+ the report ID of the desired report
+
+ ReportBufferLength The size (in bytes) of ReportBuffer. This value
+ should be greater than or equal to the
+ InputReportByteLength field as specified in the
+ HIDP_CAPS structure for the device
+Return Value:
+ TRUE if successful
+ FALSE otherwise -- Use GetLastError() to get extended error information
+--*/
+__checkReturn
+BOOLEAN __stdcall
+HidD_SetOutputReport (
+ __in HANDLE HidDeviceObject,
+ __in_bcount(ReportBufferLength) PVOID ReportBuffer,
+ __in ULONG ReportBufferLength
+ );
+/*++
+Routine Description:
+ Send an output report to a HID device.
+
+Arguments:
+ HidDeviceObject A handle to a Hid Device Object.
+
+ ReportBuffer The buffer of the output report to send to the device
+
+ ReportBufferLength The size (in bytes) of ReportBuffer. This value
+ should be greater than or equal to the
+ OutputReportByteLength field as specified in the
+ HIDP_CAPS structure for the device
+Return Value:
+ TRUE if successful
+ FALSE otherwise -- Use GetLastError() to get extended error information
+--*/
+
+#endif
+__checkReturn
+BOOLEAN __stdcall
+HidD_GetNumInputBuffers (
+ __in HANDLE HidDeviceObject,
+ __out PULONG NumberBuffers
+ );
+/*++
+Routine Description:
+ This function returns the number of input buffers used by the specified
+ file handle to the Hid device. Each file object has a number of buffers
+ associated with it to queue reports read from the device but which have
+ not yet been read by the user-mode app with a handle to that device.
+
+Arguments:
+ HidDeviceObject A handle to a Hid Device Object.
+
+ NumberBuffers Number of buffers currently being used for this file
+ handle to the Hid device
+
+Return Value:
+ TRUE if successful
+ FALSE otherwise -- Use GetLastError() to get extended error information
+--*/
+__checkReturn
+BOOLEAN __stdcall
+HidD_SetNumInputBuffers (
+ __in HANDLE HidDeviceObject,
+ __in ULONG NumberBuffers
+ );
+/*++
+
+Routine Description:
+ This function sets the number of input buffers used by the specified
+ file handle to the Hid device. Each file object has a number of buffers
+ associated with it to queue reports read from the device but which have
+ not yet been read by the user-mode app with a handle to that device.
+
+Arguments:
+ HidDeviceObject A handle to a Hid Device Object.
+
+ NumberBuffers New number of buffers to use for this file handle to
+ the Hid device
+
+Return Value:
+ TRUE if successful
+ FALSE otherwise -- Use GetLastError() to get extended error information
+--*/
+__checkReturn
+BOOLEAN __stdcall
+HidD_GetPhysicalDescriptor (
+ __in HANDLE HidDeviceObject,
+ __out_bcount(BufferLength) PVOID Buffer,
+ __in ULONG BufferLength
+ );
+/*++
+Routine Description:
+ This function retrieves the raw physical descriptor for the specified
+ Hid device.
+
+Arguments:
+ HidDeviceObject A handle to a Hid Device Object.
+
+ Buffer Buffer which on return will contain the physical
+ descriptor if one exists for the specified device
+ handle
+
+ BufferLength Length of buffer (in bytes)
+
+
+Return Value:
+ TRUE if successful
+ FALSE otherwise -- Use GetLastError() to get extended error information
+--*/
+__checkReturn
+BOOLEAN __stdcall
+HidD_GetManufacturerString (
+ __in HANDLE HidDeviceObject,
+ __out_bcount(BufferLength) PVOID Buffer,
+ __in ULONG BufferLength
+ );
+/*++
+Routine Description:
+ This function retrieves the manufacturer string from the specified
+ Hid device.
+
+Arguments:
+ HidDeviceObject A handle to a Hid Device Object.
+
+ Buffer Buffer which on return will contain the manufacturer
+ string returned from the device. This string is a
+ wide-character string
+
+ BufferLength Length of Buffer (in bytes)
+
+
+Return Value:
+ TRUE if successful
+ FALSE otherwise -- Use GetLastError() to get extended error information
+--*/
+__checkReturn
+BOOLEAN __stdcall
+HidD_GetProductString (
+ __in HANDLE HidDeviceObject,
+ __out_bcount(BufferLength) PVOID Buffer,
+ __in ULONG BufferLength
+ );
+/*++
+Routine Description:
+ This function retrieves the product string from the specified
+ Hid device.
+
+Arguments:
+ HidDeviceObject A handle to a Hid Device Object.
+
+ Buffer Buffer which on return will contain the product
+ string returned from the device. This string is a
+ wide-character string
+
+ BufferLength Length of Buffer (in bytes)
+
+
+Return Value:
+ TRUE if successful
+ FALSE otherwise -- Use GetLastError() to get extended error information
+--*/
+__checkReturn
+BOOLEAN __stdcall
+HidD_GetIndexedString (
+ __in HANDLE HidDeviceObject,
+ __in ULONG StringIndex,
+ __out_bcount(BufferLength) PVOID Buffer,
+ __in ULONG BufferLength
+ );
+/*++
+Routine Description:
+ This function retrieves a string from the specified Hid device that is
+ specified with a certain string index.
+
+Arguments:
+ HidDeviceObject A handle to a Hid Device Object.
+
+ StringIndex Index of the string to retrieve
+
+ Buffer Buffer which on return will contain the product
+ string returned from the device. This string is a
+ wide-character string
+
+ BufferLength Length of Buffer (in bytes)
+
+Return Value:
+ TRUE if successful
+ FALSE otherwise -- Use GetLastError() to get extended error information
+--*/
+__checkReturn
+BOOLEAN __stdcall
+HidD_GetSerialNumberString (
+ __in HANDLE HidDeviceObject,
+ __out_bcount(BufferLength) PVOID Buffer,
+ __in ULONG BufferLength
+ );
+/*++
+Routine Description:
+ This function retrieves the serial number string from the specified
+ Hid device.
+
+Arguments:
+ HidDeviceObject A handle to a Hid Device Object.
+
+ Buffer Buffer which on return will contain the serial number
+ string returned from the device. This string is a
+ wide-character string
+
+ BufferLength Length of Buffer (in bytes)
+
+Return Value:
+ TRUE if successful
+ FALSE otherwise -- Use GetLastError() to get extended error information
+--*/
+
+#if (NTDDI_VERSION >= NTDDI_WINXP)
+__checkReturn
+BOOLEAN __stdcall
+HidD_GetMsGenreDescriptor (
+ __in HANDLE HidDeviceObject,
+ __out_bcount(BufferLength) PVOID Buffer,
+ __in ULONG BufferLength
+ );
+/*++
+Routine Description:
+ This function retrieves the Microsoft Genre descriptor from the specified
+ Hid device.
+
+Arguments:
+ HidDeviceObject A handle to a Hid Device Object.
+
+ Buffer Buffer which on return will contain the descriptor
+ returned from the device.
+
+ BufferLength Length of Buffer (in bytes)
+
+Return Value:
+ TRUE if successful
+ FALSE otherwise -- Use GetLastError() to get extended error information
+--*/
+#endif
+
+
+#include
+
+#endif
+
diff --git a/setupapi-x64/hidusage.h b/setupapi-x64/hidusage.h
new file mode 100644
index 0000000..331b109
--- /dev/null
+++ b/setupapi-x64/hidusage.h
@@ -0,0 +1,292 @@
+/*++
+
+Copyright (c) Microsoft Corporation. All rights reserved.
+
+Module Name:
+
+ HIDUSAGE.H
+
+Abstract:
+
+ Public Definitions of HID USAGES.
+
+Environment:
+
+ Kernel & user mode
+
+--*/
+
+#ifndef __HIDUSAGE_H__
+#define __HIDUSAGE_H__
+
+//
+// Usage Pages
+//
+
+typedef USHORT USAGE, *PUSAGE;
+
+#define HID_USAGE_PAGE_UNDEFINED ((USAGE) 0x00)
+#define HID_USAGE_PAGE_GENERIC ((USAGE) 0x01)
+#define HID_USAGE_PAGE_SIMULATION ((USAGE) 0x02)
+#define HID_USAGE_PAGE_VR ((USAGE) 0x03)
+#define HID_USAGE_PAGE_SPORT ((USAGE) 0x04)
+#define HID_USAGE_PAGE_GAME ((USAGE) 0x05)
+#define HID_USAGE_PAGE_KEYBOARD ((USAGE) 0x07)
+#define HID_USAGE_PAGE_LED ((USAGE) 0x08)
+#define HID_USAGE_PAGE_BUTTON ((USAGE) 0x09)
+#define HID_USAGE_PAGE_ORDINAL ((USAGE) 0x0A)
+#define HID_USAGE_PAGE_TELEPHONY ((USAGE) 0x0B)
+#define HID_USAGE_PAGE_CONSUMER ((USAGE) 0x0C)
+#define HID_USAGE_PAGE_DIGITIZER ((USAGE) 0x0D)
+#define HID_USAGE_PAGE_UNICODE ((USAGE) 0x10)
+#define HID_USAGE_PAGE_ALPHANUMERIC ((USAGE) 0x14)
+
+//
+// Microsoft Vendor Specific Usage Pages
+//
+#define HID_USAGE_PAGE_MICROSOFT_BLUETOOTH_HANDSFREE ((USAGE) 0xFFF3)
+
+//
+// Usages from Generic Desktop Page (0x01)
+//
+
+#define HID_USAGE_GENERIC_POINTER ((USAGE) 0x01)
+#define HID_USAGE_GENERIC_MOUSE ((USAGE) 0x02)
+#define HID_USAGE_GENERIC_JOYSTICK ((USAGE) 0x04)
+#define HID_USAGE_GENERIC_GAMEPAD ((USAGE) 0x05)
+#define HID_USAGE_GENERIC_KEYBOARD ((USAGE) 0x06)
+#define HID_USAGE_GENERIC_KEYPAD ((USAGE) 0x07)
+#define HID_USAGE_GENERIC_SYSTEM_CTL ((USAGE) 0x80)
+
+#define HID_USAGE_GENERIC_X ((USAGE) 0x30)
+#define HID_USAGE_GENERIC_Y ((USAGE) 0x31)
+#define HID_USAGE_GENERIC_Z ((USAGE) 0x32)
+#define HID_USAGE_GENERIC_RX ((USAGE) 0x33)
+#define HID_USAGE_GENERIC_RY ((USAGE) 0x34)
+#define HID_USAGE_GENERIC_RZ ((USAGE) 0x35)
+#define HID_USAGE_GENERIC_SLIDER ((USAGE) 0x36)
+#define HID_USAGE_GENERIC_DIAL ((USAGE) 0x37)
+#define HID_USAGE_GENERIC_WHEEL ((USAGE) 0x38)
+#define HID_USAGE_GENERIC_HATSWITCH ((USAGE) 0x39)
+#define HID_USAGE_GENERIC_COUNTED_BUFFER ((USAGE) 0x3A)
+#define HID_USAGE_GENERIC_BYTE_COUNT ((USAGE) 0x3B)
+#define HID_USAGE_GENERIC_MOTION_WAKEUP ((USAGE) 0x3C)
+#define HID_USAGE_GENERIC_VX ((USAGE) 0x40)
+#define HID_USAGE_GENERIC_VY ((USAGE) 0x41)
+#define HID_USAGE_GENERIC_VZ ((USAGE) 0x42)
+#define HID_USAGE_GENERIC_VBRX ((USAGE) 0x43)
+#define HID_USAGE_GENERIC_VBRY ((USAGE) 0x44)
+#define HID_USAGE_GENERIC_VBRZ ((USAGE) 0x45)
+#define HID_USAGE_GENERIC_VNO ((USAGE) 0x46)
+#define HID_USAGE_GENERIC_SYSCTL_POWER ((USAGE) 0x81)
+#define HID_USAGE_GENERIC_SYSCTL_SLEEP ((USAGE) 0x82)
+#define HID_USAGE_GENERIC_SYSCTL_WAKE ((USAGE) 0x83)
+#define HID_USAGE_GENERIC_SYSCTL_CONTEXT_MENU ((USAGE) 0x84)
+#define HID_USAGE_GENERIC_SYSCTL_MAIN_MENU ((USAGE) 0x85)
+#define HID_USAGE_GENERIC_SYSCTL_APP_MENU ((USAGE) 0x86)
+#define HID_USAGE_GENERIC_SYSCTL_HELP_MENU ((USAGE) 0x87)
+#define HID_USAGE_GENERIC_SYSCTL_MENU_EXIT ((USAGE) 0x88)
+#define HID_USAGE_GENERIC_SYSCTL_MENU_SELECT ((USAGE) 0x89)
+#define HID_USAGE_GENERIC_SYSCTL_MENU_RIGHT ((USAGE) 0x8A)
+#define HID_USAGE_GENERIC_SYSCTL_MENU_LEFT ((USAGE) 0x8B)
+#define HID_USAGE_GENERIC_SYSCTL_MENU_UP ((USAGE) 0x8C)
+#define HID_USAGE_GENERIC_SYSCTL_MENU_DOWN ((USAGE) 0x8D)
+
+//
+// Usages from Simulation Controls Page (0x02)
+//
+
+#define HID_USAGE_SIMULATION_RUDDER ((USAGE) 0xBA)
+#define HID_USAGE_SIMULATION_THROTTLE ((USAGE) 0xBB)
+
+//
+// Virtual Reality Controls Page (0x03)
+//
+
+
+//
+// Sport Controls Page (0x04)
+//
+
+
+//
+// Game Controls Page (0x05)
+//
+
+
+//
+// Keyboard/Keypad Page (0x07)
+//
+
+ // Error "keys"
+#define HID_USAGE_KEYBOARD_NOEVENT ((USAGE) 0x00)
+#define HID_USAGE_KEYBOARD_ROLLOVER ((USAGE) 0x01)
+#define HID_USAGE_KEYBOARD_POSTFAIL ((USAGE) 0x02)
+#define HID_USAGE_KEYBOARD_UNDEFINED ((USAGE) 0x03)
+
+ // Letters
+#define HID_USAGE_KEYBOARD_aA ((USAGE) 0x04)
+#define HID_USAGE_KEYBOARD_zZ ((USAGE) 0x1D)
+ // Numbers
+#define HID_USAGE_KEYBOARD_ONE ((USAGE) 0x1E)
+#define HID_USAGE_KEYBOARD_ZERO ((USAGE) 0x27)
+ // Modifier Keys
+#define HID_USAGE_KEYBOARD_LCTRL ((USAGE) 0xE0)
+#define HID_USAGE_KEYBOARD_LSHFT ((USAGE) 0xE1)
+#define HID_USAGE_KEYBOARD_LALT ((USAGE) 0xE2)
+#define HID_USAGE_KEYBOARD_LGUI ((USAGE) 0xE3)
+#define HID_USAGE_KEYBOARD_RCTRL ((USAGE) 0xE4)
+#define HID_USAGE_KEYBOARD_RSHFT ((USAGE) 0xE5)
+#define HID_USAGE_KEYBOARD_RALT ((USAGE) 0xE6)
+#define HID_USAGE_KEYBOARD_RGUI ((USAGE) 0xE7)
+#define HID_USAGE_KEYBOARD_SCROLL_LOCK ((USAGE) 0x47)
+#define HID_USAGE_KEYBOARD_NUM_LOCK ((USAGE) 0x53)
+#define HID_USAGE_KEYBOARD_CAPS_LOCK ((USAGE) 0x39)
+ // Funtion keys
+#define HID_USAGE_KEYBOARD_F1 ((USAGE) 0x3A)
+#define HID_USAGE_KEYBOARD_F12 ((USAGE) 0x45)
+
+#define HID_USAGE_KEYBOARD_RETURN ((USAGE) 0x28)
+#define HID_USAGE_KEYBOARD_ESCAPE ((USAGE) 0x29)
+#define HID_USAGE_KEYBOARD_DELETE ((USAGE) 0x2A)
+
+#define HID_USAGE_KEYBOARD_PRINT_SCREEN ((USAGE) 0x46)
+
+// and hundreds more...
+
+//
+// LED Page (0x08)
+//
+
+#define HID_USAGE_LED_NUM_LOCK ((USAGE) 0x01)
+#define HID_USAGE_LED_CAPS_LOCK ((USAGE) 0x02)
+#define HID_USAGE_LED_SCROLL_LOCK ((USAGE) 0x03)
+#define HID_USAGE_LED_COMPOSE ((USAGE) 0x04)
+#define HID_USAGE_LED_KANA ((USAGE) 0x05)
+#define HID_USAGE_LED_POWER ((USAGE) 0x06)
+#define HID_USAGE_LED_SHIFT ((USAGE) 0x07)
+#define HID_USAGE_LED_DO_NOT_DISTURB ((USAGE) 0x08)
+#define HID_USAGE_LED_MUTE ((USAGE) 0x09)
+#define HID_USAGE_LED_TONE_ENABLE ((USAGE) 0x0A)
+#define HID_USAGE_LED_HIGH_CUT_FILTER ((USAGE) 0x0B)
+#define HID_USAGE_LED_LOW_CUT_FILTER ((USAGE) 0x0C)
+#define HID_USAGE_LED_EQUALIZER_ENABLE ((USAGE) 0x0D)
+#define HID_USAGE_LED_SOUND_FIELD_ON ((USAGE) 0x0E)
+#define HID_USAGE_LED_SURROUND_FIELD_ON ((USAGE) 0x0F)
+#define HID_USAGE_LED_REPEAT ((USAGE) 0x10)
+#define HID_USAGE_LED_STEREO ((USAGE) 0x11)
+#define HID_USAGE_LED_SAMPLING_RATE_DETECT ((USAGE) 0x12)
+#define HID_USAGE_LED_SPINNING ((USAGE) 0x13)
+#define HID_USAGE_LED_CAV ((USAGE) 0x14)
+#define HID_USAGE_LED_CLV ((USAGE) 0x15)
+#define HID_USAGE_LED_RECORDING_FORMAT_DET ((USAGE) 0x16)
+#define HID_USAGE_LED_OFF_HOOK ((USAGE) 0x17)
+#define HID_USAGE_LED_RING ((USAGE) 0x18)
+#define HID_USAGE_LED_MESSAGE_WAITING ((USAGE) 0x19)
+#define HID_USAGE_LED_DATA_MODE ((USAGE) 0x1A)
+#define HID_USAGE_LED_BATTERY_OPERATION ((USAGE) 0x1B)
+#define HID_USAGE_LED_BATTERY_OK ((USAGE) 0x1C)
+#define HID_USAGE_LED_BATTERY_LOW ((USAGE) 0x1D)
+#define HID_USAGE_LED_SPEAKER ((USAGE) 0x1E)
+#define HID_USAGE_LED_HEAD_SET ((USAGE) 0x1F)
+#define HID_USAGE_LED_HOLD ((USAGE) 0x20)
+#define HID_USAGE_LED_MICROPHONE ((USAGE) 0x21)
+#define HID_USAGE_LED_COVERAGE ((USAGE) 0x22)
+#define HID_USAGE_LED_NIGHT_MODE ((USAGE) 0x23)
+#define HID_USAGE_LED_SEND_CALLS ((USAGE) 0x24)
+#define HID_USAGE_LED_CALL_PICKUP ((USAGE) 0x25)
+#define HID_USAGE_LED_CONFERENCE ((USAGE) 0x26)
+#define HID_USAGE_LED_STAND_BY ((USAGE) 0x27)
+#define HID_USAGE_LED_CAMERA_ON ((USAGE) 0x28)
+#define HID_USAGE_LED_CAMERA_OFF ((USAGE) 0x29)
+#define HID_USAGE_LED_ON_LINE ((USAGE) 0x2A)
+#define HID_USAGE_LED_OFF_LINE ((USAGE) 0x2B)
+#define HID_USAGE_LED_BUSY ((USAGE) 0x2C)
+#define HID_USAGE_LED_READY ((USAGE) 0x2D)
+#define HID_USAGE_LED_PAPER_OUT ((USAGE) 0x2E)
+#define HID_USAGE_LED_PAPER_JAM ((USAGE) 0x2F)
+#define HID_USAGE_LED_REMOTE ((USAGE) 0x30)
+#define HID_USAGE_LED_FORWARD ((USAGE) 0x31)
+#define HID_USAGE_LED_REVERSE ((USAGE) 0x32)
+#define HID_USAGE_LED_STOP ((USAGE) 0x33)
+#define HID_USAGE_LED_REWIND ((USAGE) 0x34)
+#define HID_USAGE_LED_FAST_FORWARD ((USAGE) 0x35)
+#define HID_USAGE_LED_PLAY ((USAGE) 0x36)
+#define HID_USAGE_LED_PAUSE ((USAGE) 0x37)
+#define HID_USAGE_LED_RECORD ((USAGE) 0x38)
+#define HID_USAGE_LED_ERROR ((USAGE) 0x39)
+#define HID_USAGE_LED_SELECTED_INDICATOR ((USAGE) 0x3A)
+#define HID_USAGE_LED_IN_USE_INDICATOR ((USAGE) 0x3B)
+#define HID_USAGE_LED_MULTI_MODE_INDICATOR ((USAGE) 0x3C)
+#define HID_USAGE_LED_INDICATOR_ON ((USAGE) 0x3D)
+#define HID_USAGE_LED_INDICATOR_FLASH ((USAGE) 0x3E)
+#define HID_USAGE_LED_INDICATOR_SLOW_BLINK ((USAGE) 0x3F)
+#define HID_USAGE_LED_INDICATOR_FAST_BLINK ((USAGE) 0x40)
+#define HID_USAGE_LED_INDICATOR_OFF ((USAGE) 0x41)
+#define HID_USAGE_LED_FLASH_ON_TIME ((USAGE) 0x42)
+#define HID_USAGE_LED_SLOW_BLINK_ON_TIME ((USAGE) 0x43)
+#define HID_USAGE_LED_SLOW_BLINK_OFF_TIME ((USAGE) 0x44)
+#define HID_USAGE_LED_FAST_BLINK_ON_TIME ((USAGE) 0x45)
+#define HID_USAGE_LED_FAST_BLINK_OFF_TIME ((USAGE) 0x46)
+#define HID_USAGE_LED_INDICATOR_COLOR ((USAGE) 0x47)
+#define HID_USAGE_LED_RED ((USAGE) 0x48)
+#define HID_USAGE_LED_GREEN ((USAGE) 0x49)
+#define HID_USAGE_LED_AMBER ((USAGE) 0x4A)
+#define HID_USAGE_LED_GENERIC_INDICATOR ((USAGE) 0x4B)
+
+//
+// Button Page (0x09)
+//
+// There is no need to label these usages.
+//
+
+
+//
+// Ordinal Page (0x0A)
+//
+// There is no need to label these usages.
+//
+
+
+//
+// Telephony Device Page (0x0B)
+//
+
+#define HID_USAGE_TELEPHONY_PHONE ((USAGE) 0x01)
+#define HID_USAGE_TELEPHONY_ANSWERING_MACHINE ((USAGE) 0x02)
+#define HID_USAGE_TELEPHONY_MESSAGE_CONTROLS ((USAGE) 0x03)
+#define HID_USAGE_TELEPHONY_HANDSET ((USAGE) 0x04)
+#define HID_USAGE_TELEPHONY_HEADSET ((USAGE) 0x05)
+#define HID_USAGE_TELEPHONY_KEYPAD ((USAGE) 0x06)
+#define HID_USAGE_TELEPHONY_PROGRAMMABLE_BUTTON ((USAGE) 0x07)
+#define HID_USAGE_TELEPHONY_REDIAL ((USAGE) 0x24)
+#define HID_USAGE_TELEPHONY_TRANSFER ((USAGE) 0x25)
+#define HID_USAGE_TELEPHONY_DROP ((USAGE) 0x26)
+#define HID_USAGE_TELEPHONY_LINE ((USAGE) 0x2A)
+#define HID_USAGE_TELEPHONY_RING_ENABLE ((USAGE) 0x2D)
+#define HID_USAGE_TELEPHONY_SEND ((USAGE) 0x31)
+#define HID_USAGE_TELEPHONY_KEYPAD_0 ((USAGE) 0xB0)
+#define HID_USAGE_TELEPHONY_KEYPAD_D ((USAGE) 0xBF)
+#define HID_USAGE_TELEPHONY_HOST_AVAILABLE ((USAGE) 0xF1)
+
+
+//
+// Microsoft Bluetooth Handsfree Page (0xFFF3)
+//
+#define HID_USAGE_MS_BTH_HF_DIALNUMBER ((USAGE) 0x21)
+#define HID_USAGE_MS_BTH_HF_DIALMEMORY ((USAGE) 0x22)
+
+
+//
+// and others...
+//
+
+#define HID_USAGE_CONSUMERCTRL ((USAGE)0x01)
+#define HID_USAGE_DIGITIZER_PEN ((USAGE)0x02)
+#define HID_USAGE_DIGITIZER_IN_RANGE ((USAGE)0x32)
+#define HID_USAGE_DIGITIZER_TIP_SWITCH ((USAGE)0x42)
+#define HID_USAGE_DIGITIZER_BARREL_SWITCH ((USAGE)0x44)
+
+#endif
+
+
diff --git a/setupapi-x64/setupapi.dll b/setupapi-x64/setupapi.dll
new file mode 100644
index 0000000000000000000000000000000000000000..0331b84d484c0568af45517782ad08980b2afe7d
GIT binary patch
literal 4518336
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