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
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
|
/*++
Copyright (c) Microsoft Corporation, All Rights Reserved
Module Name:
queue.h
Abstract:
This file defines the queue callback interface.
Environment:
Windows User-Mode Driver Framework (WUDF)
--*/
#pragma once
#include "internal.h"
// Set ring buffer size
#define DATA_BUFFER_SIZE 1024
//
// Macro definition for defining IOCTL and FSCTL function control codes. Note
// that function codes 0-2047 are reserved for Microsoft Corporation, and
// 2048-4095 are reserved for customers.
//
#define CTL_CODE( DeviceType, Function, Method, Access ) ( \
((DeviceType) << 16) | ((Access) << 14) | ((Function) << 2) | (Method) \
)
//
// Queue Callback Object.
//
class CMyQueue :
public IQueueCallbackDeviceIoControl,
public IQueueCallbackRead,
public IQueueCallbackWrite,
public CUnknown
{
UCHAR m_CommandMatchState; // Device state
BOOL m_ConnectCommand;
BOOL m_IgnoreNextChar;
BOOL m_ConnectionStateChanged;
BOOL m_CurrentlyConnected;
IWDFIoQueue *m_FxQueue; // Default parallel queue
IWDFIoQueue *m_FxReadQueue; // Manual queue for pending reads
IWDFIoQueue *m_FxWaitMaskQueue; // Manual queue for pending ioctl wait-on-mask
CRingBuffer m_RingBuffer; // Ring buffer for pending data
PCMyDevice m_Device;
CMyQueue(
CMyDevice *pDevice
) :
m_CommandMatchState(COMMAND_MATCH_STATE_IDLE),
m_ConnectCommand(FALSE),
m_IgnoreNextChar(FALSE),
m_ConnectionStateChanged(FALSE),
m_CurrentlyConnected(FALSE),
m_FxQueue(NULL),
m_FxReadQueue(NULL)
{
WUDF_TEST_DRIVER_ASSERT(pDevice);
pDevice->AddRef();
m_Device = pDevice;
}
virtual ~CMyQueue();
HRESULT
Initialize(
_In_ IWDFDevice *FxDevice
);
VOID
CMyQueue::ProcessWriteBytes(
_In_reads_bytes_(Length) PUCHAR Characters,
_In_ SIZE_T Length
);
public:
static
HRESULT
CreateInstance(
_In_ CMyDevice *pDevice,
_In_ IWDFDevice *FxDevice,
_Out_ PCMyQueue *Queue
);
HRESULT
Configure(
VOID
)
{
return S_OK;
}
IQueueCallbackDeviceIoControl *
QueryIQueueCallbackDeviceIoControl(
VOID
)
{
AddRef();
return static_cast<IQueueCallbackDeviceIoControl *>(this);
}
IQueueCallbackRead *
QueryIQueueCallbackRead(
VOID
)
{
AddRef();
return static_cast<IQueueCallbackRead *>(this);
}
IQueueCallbackWrite *
QueryIQueueCallbackWrite(
VOID
)
{
AddRef();
return static_cast<IQueueCallbackWrite *>(this);
}
//
// IUnknown
//
virtual
ULONG
STDMETHODCALLTYPE
AddRef(
VOID
) {
return CUnknown::AddRef();
}
_At_(this, __drv_freesMem(object))
virtual
ULONG
STDMETHODCALLTYPE
Release(
VOID
) {
return CUnknown::Release();
}
virtual
HRESULT
STDMETHODCALLTYPE
QueryInterface(
_In_ REFIID InterfaceId,
_Out_ PVOID *Object
);
//
// Wdf Callbacks
//
// IQueueCallbackDeviceIoControl
//
virtual
VOID
STDMETHODCALLTYPE
OnDeviceIoControl(
_In_ IWDFIoQueue *pWdfQueue,
_In_ IWDFIoRequest *pWdfRequest,
_In_ ULONG ControlCode,
_In_ SIZE_T InputBufferSizeInBytes,
_In_ SIZE_T OutputBufferSizeInBytes
);
// IQueueCallbackWrite
//
virtual
VOID
STDMETHODCALLTYPE
OnWrite(
_In_ IWDFIoQueue *pWdfQueue,
_In_ IWDFIoRequest *pWdfRequest,
_In_ SIZE_T NumOfBytesToWrite
);
// IQueueCallbackRead
//
virtual
VOID
STDMETHODCALLTYPE
OnRead(
_In_ IWDFIoQueue *pWdfQueue,
_In_ IWDFIoRequest *pWdfRequest,
_In_ SIZE_T NumOfBytesToRead
);
};
|
