1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
|
/*++
Copyright (C) Microsoft Corporation, All Rights Reserved
Module Name:
vhidmini.h
Abstract:
This module contains the type definitions for the driver
Environment:
Windows Driver Framework (WDF)
--*/
#ifdef _KERNEL_MODE
#include <ntddk.h>
#else
#include <windows.h>
#endif
#include <wdf.h>
#include <hidport.h> // located in $(DDK_INC_PATH)/wdm
#include "common.h"
typedef UCHAR HID_REPORT_DESCRIPTOR, *PHID_REPORT_DESCRIPTOR;
DRIVER_INITIALIZE DriverEntry;
EVT_WDF_DRIVER_DEVICE_ADD EvtDeviceAdd;
EVT_WDF_TIMER EvtTimerFunc;
typedef struct _DEVICE_CONTEXT
{
WDFDEVICE Device;
WDFQUEUE DefaultQueue;
WDFQUEUE ManualQueue;
HID_DEVICE_ATTRIBUTES HidDeviceAttributes;
BYTE DeviceData;
HID_DESCRIPTOR HidDescriptor;
PHID_REPORT_DESCRIPTOR ReportDescriptor;
BOOLEAN ReadReportDescFromRegistry;
} DEVICE_CONTEXT, *PDEVICE_CONTEXT;
WDF_DECLARE_CONTEXT_TYPE_WITH_NAME(DEVICE_CONTEXT, GetDeviceContext);
typedef struct _QUEUE_CONTEXT
{
WDFQUEUE Queue;
PDEVICE_CONTEXT DeviceContext;
UCHAR OutputReport;
} QUEUE_CONTEXT, *PQUEUE_CONTEXT;
WDF_DECLARE_CONTEXT_TYPE_WITH_NAME(QUEUE_CONTEXT, GetQueueContext);
NTSTATUS
QueueCreate(
_In_ WDFDEVICE Device,
_Out_ WDFQUEUE *Queue
);
typedef struct _MANUAL_QUEUE_CONTEXT
{
WDFQUEUE Queue;
PDEVICE_CONTEXT DeviceContext;
WDFTIMER Timer;
} MANUAL_QUEUE_CONTEXT, *PMANUAL_QUEUE_CONTEXT;
WDF_DECLARE_CONTEXT_TYPE_WITH_NAME(MANUAL_QUEUE_CONTEXT, GetManualQueueContext);
NTSTATUS
ManualQueueCreate(
_In_ WDFDEVICE Device,
_Out_ WDFQUEUE *Queue
);
NTSTATUS
ReadReport(
_In_ PQUEUE_CONTEXT QueueContext,
_In_ WDFREQUEST Request,
_Always_(_Out_)
BOOLEAN* CompleteRequest
);
NTSTATUS
WriteReport(
_In_ PQUEUE_CONTEXT QueueContext,
_In_ WDFREQUEST Request
);
NTSTATUS
GetFeature(
_In_ PQUEUE_CONTEXT QueueContext,
_In_ WDFREQUEST Request
);
NTSTATUS
SetFeature(
_In_ PQUEUE_CONTEXT QueueContext,
_In_ WDFREQUEST Request
);
NTSTATUS
GetInputReport(
_In_ PQUEUE_CONTEXT QueueContext,
_In_ WDFREQUEST Request
);
NTSTATUS
SetOutputReport(
_In_ PQUEUE_CONTEXT QueueContext,
_In_ WDFREQUEST Request
);
NTSTATUS
GetString(
_In_ WDFREQUEST Request
);
NTSTATUS
GetIndexedString(
_In_ WDFREQUEST Request
);
NTSTATUS
GetStringId(
_In_ WDFREQUEST Request,
_Out_ ULONG *StringId,
_Out_ ULONG *LanguageId
);
NTSTATUS
RequestCopyFromBuffer(
_In_ WDFREQUEST Request,
_In_ PVOID SourceBuffer,
_When_(NumBytesToCopyFrom == 0, __drv_reportError(NumBytesToCopyFrom cannot be zero))
_In_ size_t NumBytesToCopyFrom
);
NTSTATUS
RequestGetHidXferPacket_ToReadFromDevice(
_In_ WDFREQUEST Request,
_Out_ HID_XFER_PACKET *Packet
);
NTSTATUS
RequestGetHidXferPacket_ToWriteToDevice(
_In_ WDFREQUEST Request,
_Out_ HID_XFER_PACKET *Packet
);
NTSTATUS
CheckRegistryForDescriptor(
_In_ WDFDEVICE Device
);
NTSTATUS
ReadDescriptorFromRegistry(
_In_ WDFDEVICE Device
);
//
// Misc definitions
//
#define CONTROL_FEATURE_REPORT_ID 0x01
//
// These are the device attributes returned by the mini driver in response
// to IOCTL_HID_GET_DEVICE_ATTRIBUTES.
//
#define HIDMINI_PID 0xFEED
#define HIDMINI_VID 0xDEED
#define HIDMINI_VERSION 0x0101
|
