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
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
|
/*++
Copyright (c) 1989-1993 Microsoft Corporation
Module Name:
spxdev.c
Abstract:
This module contains code which implements the DEVICE_CONTEXT object.
Routines are provided to reference, and dereference transport device
context objects.
The transport device context object is a structure which contains a
system-defined DEVICE_OBJECT followed by information which is maintained
by the transport provider, called the context.
Author:
Nikhil Kamkolkar (nikhilk) 11-November-1993
Environment:
Kernel mode
Revision History:
--*/
#include "precomp.h"
#pragma hdrstop
// Define module number for event logging entries
#define FILENUM SPXDEV
#ifdef ALLOC_PRAGMA
#pragma alloc_text(INIT, SpxInitCreateDevice)
#pragma alloc_text(PAGE, SpxDestroyDevice)
#endif
VOID
SpxDerefDevice(
IN PDEVICE Device
)
/*++
Routine Description:
This routine dereferences a device context by decrementing the
reference count contained in the structure. Currently, we don't
do anything special when the reference count drops to zero, but
we could dynamically unload stuff then.
Arguments:
Device - Pointer to a transport device context object.
Return Value:
none.
--*/
{
LONG result;
result = InterlockedDecrement (&Device->dev_RefCount);
CTEAssert (result >= 0);
if (result == 0)
{
// Close binding to IPX
SpxUnbindFromIpx();
// Set unload event.
KeSetEvent(&SpxUnloadEvent, IO_NETWORK_INCREMENT, FALSE);
}
} // SpxDerefDevice
NTSTATUS
SpxInitCreateDevice(
IN PDRIVER_OBJECT DriverObject,
IN PUNICODE_STRING DeviceName,
IN OUT PDEVICE * DevicePtr
)
/*++
Routine Description:
This routine creates and initializes a device context structure.
Arguments:
DriverObject - pointer to the IO subsystem supplied driver object.
Device - Pointer to a pointer to a transport device context object.
DeviceName - pointer to the name of the device this device object points to.
Return Value:
STATUS_SUCCESS if all is well; STATUS_INSUFFICIENT_RESOURCES otherwise.
--*/
{
NTSTATUS status;
PDEVICE_OBJECT deviceObject;
PDEVICE Device;
ULONG DeviceSize;
ULONG DeviceNameOffset;
DBGPRINT(DEVICE, INFO,
("SpxInitCreateDevice - Create device %ws\n", DeviceName->Buffer));
// Create the device object for the sample transport, allowing
// room at the end for the device name to be stored (for use
// in logging errors).
DeviceSize = sizeof(DEVICE) - sizeof(DEVICE_OBJECT) +
DeviceName->Length + sizeof(UNICODE_NULL);
status = IoCreateDevice(
DriverObject,
DeviceSize,
DeviceName,
FILE_DEVICE_TRANSPORT,
0,
FALSE,
&deviceObject);
if (!NT_SUCCESS(status)) {
DBGPRINT(DEVICE, ERR, ("IoCreateDevice failed\n"));
return status;
}
deviceObject->Flags |= DO_DIRECT_IO;
Device = (PDEVICE)deviceObject;
DBGPRINT(DEVICE, INFO, ("IoCreateDevice succeeded %lx\n", Device));
// Initialize our part of the device context.
RtlZeroMemory(
((PUCHAR)Device) + sizeof(DEVICE_OBJECT),
sizeof(DEVICE) - sizeof(DEVICE_OBJECT));
DeviceNameOffset = sizeof(DEVICE);
// Copy over the device name.
Device->dev_DeviceNameLen = DeviceName->Length + sizeof(WCHAR);
Device->dev_DeviceName = (PWCHAR)(((PUCHAR)Device) + DeviceNameOffset);
RtlCopyMemory(
Device->dev_DeviceName,
DeviceName->Buffer,
DeviceName->Length);
Device->dev_DeviceName[DeviceName->Length/sizeof(WCHAR)] = UNICODE_NULL;
// Initialize the reference count.
Device->dev_RefCount = 1;
#if DBG
Device->dev_RefTypes[DREF_CREATE] = 1;
#endif
#if DBG
RtlCopyMemory(Device->dev_Signature1, "IDC1", 4);
RtlCopyMemory(Device->dev_Signature2, "IDC2", 4);
#endif
// Set next conn id to be used.
Device->dev_NextConnId = (USHORT)SpxRandomNumber();
if (Device->dev_NextConnId == 0xFFFF)
{
Device->dev_NextConnId = 1;
}
DBGPRINT(DEVICE, ERR,
("SpxInitCreateDevice: Start Conn Id %lx\n", Device->dev_NextConnId));
// Initialize the resource that guards address ACLs.
ExInitializeResource (&Device->dev_AddrResource);
// initialize the various fields in the device context
CTEInitLock (&Device->dev_Interlock);
CTEInitLock (&Device->dev_Lock);
KeInitializeSpinLock (&Device->dev_StatInterlock);
KeInitializeSpinLock (&Device->dev_StatSpinLock);
Device->dev_State = DEVICE_STATE_CLOSED;
Device->dev_Type = SPX_DEVICE_SIGNATURE;
Device->dev_Size = sizeof (DEVICE);
Device->dev_Stat.Version = 0x100;
*DevicePtr = Device;
return STATUS_SUCCESS;
} // SpxCreateDevice
VOID
SpxDestroyDevice(
IN PDEVICE Device
)
/*++
Routine Description:
This routine destroys a device context structure.
Arguments:
Device - Pointer to a pointer to a transport device context object.
Return Value:
None.
--*/
{
ExDeleteResource (&Device->dev_AddrResource);
IoDeleteDevice ((PDEVICE_OBJECT)Device);
} // SpxDestroyDevice
|