Windows驱动开发技术详解源码

/*++ Copyright (c) 2000 Microsoft Corporation Module Name: bulkpnp.c Abstract: Bulk USB device driver for Intel 82930 USB test board Plug and Play module. This file contains routines to handle pnp requests. These routines are not USB specific but is required for every driver which conforms to the WDM model. Environment: Kernel mode Notes: Copyright (c) 2000 Microsoft Corporation. All Rights Reserved. --*/ #include "bulkusb.h" #include "bulkpnp.h" #include "bulkpwr.h" #include "bulkdev.h" #include "bulkrwr.h" #include "bulkwmi.h" #include "bulkusr.h" NTSTATUS BulkUsb_DispatchPnP( IN PDEVICE_OBJECT DeviceObject, IN PIRP Irp ) /*++ Routine Description: The plug and play dispatch routines. Most of these requests the driver will completely ignore. In all cases it must pass on the IRP to the lower driver. Arguments: DeviceObject - pointer to a device object. Irp - pointer to an I/O Request Packet. Return Value: NT status value --*/ { PIO_STACK_LOCATION irpStack; PDEVICE_EXTENSION deviceExtension; KEVENT startDeviceEvent; NTSTATUS ntStatus; // // initialize variables // irpStack = IoGetCurrentIrpStackLocation(Irp); deviceExtension = DeviceObject->DeviceExtension; // // since the device is removed, fail the Irp. // if(Removed == deviceExtension->DeviceState) { ntStatus = STATUS_DELETE_PENDING; Irp->IoStatus.Status = ntStatus; Irp->IoStatus.Information = 0; IoCompleteRequest(Irp, IO_NO_INCREMENT); return ntStatus; } BulkUsb_DbgPrint(3, ("///////////////////////////////////////////\n")); BulkUsb_DbgPrint(3, ("BulkUsb_DispatchPnP::")); BulkUsb_IoIncrement(deviceExtension); if(irpStack->MinorFunction == IRP_MN_START_DEVICE) { ASSERT(deviceExtension->IdleReqPend == 0); } else { if(deviceExtension->SSEnable) { CancelSelectSuspend(deviceExtension); } } BulkUsb_DbgPrint(2, (PnPMinorFunctionString(irpStack->MinorFunction))); switch(irpStack->MinorFunction) { case IRP_MN_START_DEVICE: ntStatus = HandleStartDevice(DeviceObject, Irp); break; case IRP_MN_QUERY_STOP_DEVICE: // // if we cannot stop the device, we fail the query stop irp // ntStatus = CanStopDevice(DeviceObject, Irp); if(NT_SUCCESS(ntStatus)) { ntStatus = HandleQueryStopDevice(DeviceObject, Irp); return ntStatus; } break; case IRP_MN_CANCEL_STOP_DEVICE: ntStatus = HandleCancelStopDevice(DeviceObject, Irp); break; case IRP_MN_STOP_DEVICE: ntStatus = HandleStopDevice(DeviceObject, Irp); BulkUsb_DbgPrint(3, ("BulkUsb_DispatchPnP::IRP_MN_STOP_DEVICE::")); BulkUsb_IoDecrement(deviceExtension); return ntStatus; case IRP_MN_QUERY_REMOVE_DEVICE: // // if we cannot remove the device, we fail the query remove irp // ntStatus = HandleQueryRemoveDevice(DeviceObject, Irp); return ntStatus; case IRP_MN_CANCEL_REMOVE_DEVICE: ntStatus = HandleCancelRemoveDevice(DeviceObject, Irp); break; case IRP_MN_SURPRISE_REMOVAL: ntStatus = HandleSurpriseRemoval(DeviceObject, Irp); BulkUsb_DbgPrint(3, ("BulkUsb_DispatchPnP::IRP_MN_SURPRISE_REMOVAL::")); BulkUsb_IoDecrement(deviceExtension); return ntStatus; case IRP_MN_REMOVE_DEVICE: ntStatus = HandleRemoveDevice(DeviceObject, Irp); return ntStatus; case IRP_MN_QUERY_CAPABILITIES: ntStatus = HandleQueryCapabilities(DeviceObject, Irp); break; default: IoSkipCurrentIrpStackLocation(Irp); ntStatus = IoCallDriver(deviceExtension->TopOfStackDeviceObject, Irp); BulkUsb_DbgPrint(3, ("BulkUsb_DispatchPnP::default::")); BulkUsb_IoDecrement(deviceExtension); return ntStatus; } // switch // // complete request // Irp->IoStatus.Status = ntStatus; Irp->IoStatus.Information = 0; IoCompleteRequest(Irp, IO_NO_INCREMENT); // // decrement count // BulkUsb_DbgPrint(3, ("BulkUsb_DispatchPnP::")); BulkUsb_IoDecrement(deviceExtension); return ntStatus; } NTSTATUS HandleStartDevice( IN PDEVICE_OBJECT DeviceObject, IN PIRP Irp ) /*++ Routine Description: This is the dispatch routine for IRP_MN_START_DEVICE Arguments: DeviceObject - pointer to a device object. Irp - I/O request packet Return Value: NT status value --*/ { KIRQL oldIrql; KEVENT startDeviceEvent; NTSTATUS ntStatus; PDEVICE_EXTENSION deviceExtension; LARGE_INTEGER dueTime; BulkUsb_DbgPrint(3, ("HandleStartDevice - begins\n")); // // initialize variables // deviceExtension = (PDEVICE_EXTENSION) DeviceObject->DeviceExtension; deviceExtension->UsbConfigurationDescriptor = NULL; deviceExtension->UsbInterface = NULL; deviceExtension->PipeContext = NULL; // // We cannot touch the device (send it any non pnp irps) until a // start device has been passed down to the lower drivers. // first pass the Irp down // KeInitializeEvent(&startDeviceEvent, NotificationEvent, FALSE); IoCopyCurrentIrpStackLocationToNext(Irp); IoSetCompletionRoutine(Irp, (PIO_COMPLETION_ROUTINE)IrpCompletionRoutine, (PVOID)&startDeviceEvent, TRUE, TRUE, TRUE); ntStatus = IoCallDriver(deviceExtension->TopOfStackDeviceObject, Irp); if(ntStatus == STATUS_PENDING) { KeWaitForSingleObject(&startDeviceEvent, Executive, KernelMode, FALSE, NULL); ntStatus = Irp->IoStatus.Status; } if(!NT_SUCCESS(ntStatus)) { BulkUsb_DbgPrint(1, ("Lower drivers failed this Irp\n")); return ntStatus; } // // Read the device descriptor, configuration descriptor // and select the interface descriptors // ntStatus = ReadandSelectDescriptors(DeviceObject); if(!NT_SUCCESS(ntStatus)) { BulkUsb_DbgPrint(1, ("ReadandSelectDescriptors failed\n")); return ntStatus; } // // enable the symbolic links for system components to open // handles to the device // ntStatus = IoSetDeviceInterfaceState(&deviceExtension->InterfaceName, TRUE); if(!NT_SUCCESS(ntStatus)) { BulkUsb_DbgPrint(1, ("IoSetDeviceInterfaceState:enable:failed\n")); return ntStatus; } KeAcquireSpinLock(&deviceExtension->DevStateLock, &oldIrql); SET_NEW_PNP_STATE(deviceExtension, Working); deviceExtension->QueueState = AllowRequests; KeReleaseSpinLock(&deviceExtension->DevStateLock, oldIrql); // // initialize wait wake outstanding flag to false. // and issue a wait wake. deviceExtension->FlagWWOutstanding = 0; deviceExtension->FlagWWCancel = 0; deviceExtension->WaitWakeIrp = NULL; if(deviceExtension->WaitWakeEnable) { IssueWaitWake(deviceExtension); } ProcessQueuedRequests(deviceExtension); if(WinXpOrBetter == deviceExtension->WdmVersion) { deviceExtension->SSEnable = deviceExtension->SSRegistryEnabl