VirtualBox

source: vbox/trunk/src/VBox/Additions/WINNT/VBoxGuest/NTLegacy.cpp@ 8155

Last change on this file since 8155 was 8155, checked in by vboxsync, 17 years ago

The Big Sun Rebranding Header Change
  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 12.2 KB
Line 
1/** @file
2 *
3 * VBoxGuest -- VirtualBox Win32 guest support driver
4 *
5 * Copyright (C) 2006-2007 Sun Microsystems, Inc.
6 *
7 * This file is part of VirtualBox Open Source Edition (OSE), as
8 * available from http://www.virtualbox.org. This file is free software;
9 * you can redistribute it and/or modify it under the terms of the GNU
10 * General Public License (GPL) as published by the Free Software
11 * Foundation, in version 2 as it comes in the "COPYING" file of the
12 * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
13 * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
14 *
15 * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa
16 * Clara, CA 95054 USA or visit http://www.sun.com if you need
17 * additional information or have any questions.
18 */
19
20// enable backdoor logging
21//#define LOG_ENABLED
22
23/*******************************************************************************
24* Header Files *
25*******************************************************************************/
26#include "NTLegacy.h"
27#include "Helper.h"
28
29#include <VBox/VBoxGuestLib.h>
30
31/*******************************************************************************
32* Defined Constants And Macros *
33*******************************************************************************/
34
35
36/*******************************************************************************
37* Internal Functions *
38*******************************************************************************/
39extern "C"
40{
41static NTSTATUS findPCIDevice(PULONG pBusNumber, PPCI_SLOT_NUMBER pSlotNumber);
42static void freeDeviceResources(PDRIVER_OBJECT pDrvObj, PDEVICE_OBJECT pDevObj);
43}
44
45#ifdef ALLOC_PRAGMA
46#pragma alloc_text (INIT, ntCreateDevice)
47#pragma alloc_text (INIT, findPCIDevice)
48#pragma alloc_text (INIT, freeDeviceResources)
49#endif
50
51/**
52 * Helper function to create the device object
53 *
54 * @returns NT status code
55 * @param
56 */
57NTSTATUS ntCreateDevice(PDRIVER_OBJECT pDrvObj, PDEVICE_OBJECT pDevObj, PUNICODE_STRING pRegPath)
58{
59 ULONG busNumber, slotNumber;
60// ULONG i;
61 NTSTATUS rc = STATUS_SUCCESS;
62
63 dprintf(("VBoxGuest::ntCreateDevice: entered\n"));
64
65 // find our virtual PCI device
66 rc = findPCIDevice(&busNumber, (PCI_SLOT_NUMBER*)&slotNumber);
67 if (!NT_SUCCESS(rc))
68 {
69 dprintf(("VBoxGuest::createDevice: device not found, returning\n"));
70 return rc;
71 }
72
73 /*
74 * Create device.
75 */
76 PDEVICE_OBJECT deviceObject = NULL;
77 UNICODE_STRING DevName;
78 RtlInitUnicodeString(&DevName, VBOXGUEST_DEVICE_NAME_NT);
79 rc = IoCreateDevice(pDrvObj, sizeof(VBOXGUESTDEVEXT), &DevName, FILE_DEVICE_UNKNOWN, 0, FALSE, &deviceObject);
80 if (!NT_SUCCESS(rc))
81 {
82 dprintf(("VBoxGuest::ntCreateDevice: IoCreateDevice failed with rc=%#x!\n", rc));
83 return rc;
84 }
85 dprintf(("VBoxGuest::ntCreateDevice: device created\n"));
86 UNICODE_STRING DosName;
87 RtlInitUnicodeString(&DosName, VBOXGUEST_DEVICE_NAME_DOS);
88 rc = IoCreateSymbolicLink(&DosName, &DevName);
89 if (!NT_SUCCESS(rc))
90 {
91 dprintf(("VBoxGuest::ntCreateDevice: IoCreateSymbolicLink failed with rc=%#x!\n", rc));
92 IoDeleteDevice(deviceObject);
93 return rc;
94 }
95 dprintf(("VBoxGuest::ntCreateDevice: symlink created\n"));
96
97 /*
98 * Setup the device extension.
99 */
100 PVBOXGUESTDEVEXT pDevExt = (PVBOXGUESTDEVEXT)deviceObject->DeviceExtension;
101 RtlZeroMemory(pDevExt, sizeof(VBOXGUESTDEVEXT));
102
103 if (pDevObj)
104 {
105 pDevExt->nextLowerDriver = IoAttachDeviceToDeviceStack(deviceObject, pDevObj);
106 if (pDevExt->nextLowerDriver == NULL)
107 {
108 dprintf(("VBoxGuest::ntCreateDevice: IoAttachDeviceToDeviceStack did not give a nextLowerDrive\n"));
109 IoDeleteSymbolicLink(&DosName);
110 IoDeleteDevice(deviceObject);
111 return STATUS_NO_SUCH_DEVICE;
112 }
113 }
114 // store a reference to ourself
115 pDevExt->deviceObject = deviceObject;
116 // store bus and slot number we've queried before
117 pDevExt->busNumber = busNumber;
118 pDevExt->slotNumber = slotNumber;
119
120 //
121 // let's have a look at what our PCI adapter offers
122 //
123 dprintf(("VBoxGuest::ntCreateDevice: starting to scan PCI resources of VBoxGuest\n"));
124 // assign the PCI resources
125 PCM_RESOURCE_LIST resourceList;
126 UNICODE_STRING classNameString;
127 RtlInitUnicodeString(&classNameString, L"VBoxGuestAdapter");
128 rc = HalAssignSlotResources(pRegPath, &classNameString,
129 pDrvObj, pDevObj,
130 PCIBus, busNumber, slotNumber,
131 &resourceList);
132 if (!NT_SUCCESS(rc))
133 {
134 dprintf(("VBoxGuest::ntCreateDevice: HalAssignSlotResources failed with rc=%#x!\n", rc));
135 freeDeviceResources(pDrvObj, pDevObj);
136 return rc;
137 }
138
139 rc = VBoxScanPCIResourceList(resourceList, pDevExt);
140
141 rc = VbglInit (pDevExt->startPortAddress, pDevExt->pVMMDevMemory);
142 if (!VBOX_SUCCESS(rc))
143 {
144 dprintf(("VBoxGuest::START_DEVICE: VbglInit failed. rc = %d\n", rc));
145 }
146
147
148 rc = VbglGRAlloc ((VMMDevRequestHeader **)&pDevExt->irqAckEvents, sizeof (VMMDevEvents), VMMDevReq_AcknowledgeEvents);
149 if (!VBOX_SUCCESS(rc))
150 {
151 dprintf(("VBoxGuest::START_DEVICE: VbglAlloc failed. rc = %d\n", rc));
152 }
153
154#if 0
155 //
156 // now proceed to the busmaster DMA stuff
157 //
158
159 DEVICE_DESCRIPTION deviceDescription;
160 ULONG numberOfMapRegisters;
161 deviceDescription.Version = DEVICE_DESCRIPTION_VERSION;
162 deviceDescription.Master = TRUE;
163 deviceDescription.ScatterGather = TRUE;
164 deviceDescription.BusNumber = pDevExt->busNumber;
165 deviceDescription.InterfaceType = PCIBus;
166 deviceDescription.MaximumLength = MAXIMUM_TRANSFER_LENGTH;
167 pDevExt->adapterObject = HalGetAdapter(&deviceDescription, &numberOfMapRegisters);
168 if (pDevExt->adapterObject == NULL)
169 {
170 dprintf(("VBoxGuest::ntCreateDevice: HalGetAdapter failed!\n"));
171 freeDeviceResources(pDrvObj, pDevObj);
172 return rc;
173 }
174
175 // @todo allocate S/G buffer
176#endif
177
178
179 //
180 // it's time to map the I/O and memory spaces
181 //
182
183 // Map physical address of VMMDev memory
184 rc = hlpVBoxMapVMMDevMemory (pDevExt);
185 if (!NT_SUCCESS(rc))
186 {
187 dprintf(("VBoxGuest::ntCreateDevice: Unable to map VMMDev Memory, rc=%#x!\n", rc));
188 freeDeviceResources(pDrvObj, pDevObj);
189 return rc;
190 }
191
192 //
193 // now we need an ISR and DPC
194 //
195
196 // register DPC routine
197 dprintf(("VBoxGuest::ntCreateDevice: initializing DPC...\n"));
198 IoInitializeDpcRequest(pDevExt->deviceObject, VBoxGuestDpcHandler);
199 // get an interrupt vector
200 ULONG vector;
201 KIRQL irql;
202 KAFFINITY affinity;
203 // only proceed if the device provides an interrupt
204 if (pDevExt->interruptLevel || pDevExt->interruptVector)
205 {
206 vector = HalGetInterruptVector(PCIBus,
207 pDevExt->busNumber,
208 pDevExt->interruptLevel,
209 pDevExt->interruptVector,
210 &irql,
211 &affinity);
212 dprintf(("VBoxGuest::ntCreateDevice: HalGetInterruptVector returns vector %u\n", vector));
213 rc = IoConnectInterrupt(&pDevExt->interruptObject, // out: interrupt object
214 (PKSERVICE_ROUTINE)VBoxGuestIsrHandler, // ISR
215 pDevExt, // context
216 NULL, // optional spinlock
217 vector, // interrupt vector
218 irql, // interrupt level
219 irql, // interrupt level
220 pDevExt->interruptMode, // LevelSensitive or Latched
221 TRUE, // shareable interrupt
222 affinity, // CPU affinity
223 FALSE); // don't save FPU stack
224 if (!NT_SUCCESS(rc))
225 {
226 dprintf(("VBoxGuest::ntCreateDevice: Unable to connect interrupt, rc=%#x!\n", rc));
227 pDevExt->interruptObject = NULL;
228 freeDeviceResources(pDrvObj, pDevObj);
229 return rc;
230 }
231 dprintf(("VBoxGuest::ntCreateDevice: IRQ connected!\n"));
232 }
233
234 if (NT_SUCCESS(rc))
235 {
236 // create our thread to inform the VBoxMouse driver
237 rc = createThreads(pDevExt);
238 }
239
240 if (NT_SUCCESS(rc))
241 {
242 // initialize the event notification semaphore
243 KeInitializeEvent(&pDevExt->keventNotification, NotificationEvent, FALSE);
244 }
245
246 rc = hlpVBoxReportGuestInfo (pDevExt);
247 if (!NT_SUCCESS(rc))
248 {
249 dprintf(("VBoxGuest::AddDevice: could not report information to host, rc = %d, exiting!\n", rc));
250 freeDeviceResources(pDrvObj, pDevObj);
251 return STATUS_UNSUCCESSFUL;
252 }
253
254 /** @todo cleanup on failure */
255
256 VBoxInitMemBalloon(pDevExt);
257
258 // ready to rumble!
259 pDevExt->devState = WORKING;
260 dprintf(("returning from createDevice with rc = 0x%x\n", rc));
261 return rc;
262}
263
264
265/**
266 * Helper function to handle the PCI device lookup
267 *
268 * @returns NT error codes
269 */
270static NTSTATUS findPCIDevice(PULONG pBusNumber, PPCI_SLOT_NUMBER pSlotNumber)
271{
272 NTSTATUS rc;
273
274 ULONG busNumber;
275 ULONG deviceNumber;
276 ULONG functionNumber;
277 PCI_SLOT_NUMBER slotNumber;
278 PCI_COMMON_CONFIG pciData;
279
280 dprintf(("findPCIDevice\n"));
281
282 rc = STATUS_DEVICE_DOES_NOT_EXIST;
283 slotNumber.u.AsULONG = 0;
284 // scan each bus
285 for (busNumber = 0; busNumber < PCI_MAX_BUSES; busNumber++)
286 {
287 // scan each device
288 for (deviceNumber = 0; deviceNumber < PCI_MAX_DEVICES; deviceNumber++)
289 {
290 slotNumber.u.bits.DeviceNumber = deviceNumber;
291 // scan each function (not really required...)
292 for (functionNumber = 0; functionNumber < PCI_MAX_FUNCTION; functionNumber++)
293 {
294 slotNumber.u.bits.FunctionNumber = functionNumber;
295 // have a look at what's in this slot
296 if (!HalGetBusData(PCIConfiguration, busNumber, slotNumber.u.AsULONG,
297 &pciData, sizeof(ULONG)))
298 {
299 // no such bus, we're done with it
300 deviceNumber = PCI_MAX_DEVICES;
301 break;
302 }
303
304 if (pciData.VendorID == PCI_INVALID_VENDORID)
305 {
306 // we have to proceed to the next function
307 continue;
308 }
309
310 // check if it's another device
311 if ((pciData.VendorID != VMMDEV_VENDORID) ||
312 (pciData.DeviceID != VMMDEV_DEVICEID))
313 {
314 continue;
315 }
316
317 // Hooray, we've found it!
318 dprintf(("device found!\n"));
319 *pBusNumber = busNumber;
320 *pSlotNumber = slotNumber;
321 rc = STATUS_SUCCESS;
322 }
323 }
324 }
325
326 return rc;
327}
328
329/**
330 * Helper function to cleanup resources
331 *
332 * @param pDrvObj Driver object.
333 * @param pDevObj Device object.
334 */
335static void freeDeviceResources(PDRIVER_OBJECT pDrvObj, PDEVICE_OBJECT pDevObj)
336{
337 PVBOXGUESTDEVEXT pDevExt = (PVBOXGUESTDEVEXT)pDevObj->DeviceExtension;
338
339 // if there's no device extension, we're screwed
340 if (!pDevExt)
341 {
342 dprintf(("freeDeviceResources: FATAL ERROR! device extension pointer is NULL! Not freeing resources!\n"));
343 return;
344 }
345
346 // indicate that the device is no longer ready
347 pDevExt->devState = STOPPED;
348
349 // disconnect interrupts
350 if (pDevExt->interruptObject)
351 {
352 IoDisconnectInterrupt(pDevExt->interruptObject);
353 }
354
355 // unmap mem/io resources
356 hlpVBoxUnmapVMMDevMemory (pDevExt);
357
358 VBoxCleanupMemBalloon(pDevExt);
359}
360
Note: See TracBrowser for help on using the repository browser.

© 2024 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette