多设备驱动程序？ （KMDF/WDF）

Question

我刚刚编写了一个 KMDF USB 驱动程序。现在我想将多个（最多至少四个）设备连接到 PC。我从哪里开始？我注意到，当我将第二个设备连接到 PC 时，它使用与第一个连接的设备完全相同的驱动程序实例。 EvtDeviceAdd(...) 每个设备运行一次，由于我没有对多个设备进行任何处理，事情变得很奇怪...现在我的 EvtDeviceAdd 看起来像这样：

NTSTATUS EvtDeviceAdd(IN WDFDRIVER Driver, IN PWDFDEVICE_INIT DeviceInit) {
    WDF_PNPPOWER_EVENT_CALLBACKS        pnpPowerCallbacks;
    WDF_OBJECT_ATTRIBUTES               attributes;
    NTSTATUS                            status;
    WDFDEVICE                           device;
    WDF_DEVICE_PNP_CAPABILITIES         pnpCaps;
    WDF_IO_QUEUE_CONFIG                 ioQueueConfig;
    PDEVICE_CONTEXT                     pDevContext;
    WDFQUEUE                            queue;
    PWSTR                               driverRegistryPath;

    UNREFERENCED_PARAMETER(Driver);
    PAGED_CODE();

    DbgPrint("New device was added\n");

    WDF_PNPPOWER_EVENT_CALLBACKS_INIT(&pnpPowerCallbacks);
    pnpPowerCallbacks.EvtDevicePrepareHardware = EvtDevicePrepareHardware;
    WdfDeviceInitSetPnpPowerEventCallbacks(DeviceInit, &pnpPowerCallbacks);

    WdfDeviceInitSetIoType(DeviceInit, WdfDeviceIoBuffered);

    WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&attributes, DEVICE_CONTEXT);

    status = WdfDeviceCreate(&DeviceInit, &attributes, &device);
    if (!NT_SUCCESS(status)) {
        DbgPrint("WdfDeviceCreate failed with Status code %!STATUS!\n", status);
        return status;
    }

    pDevContext = GetDeviceContext(device);

    WDF_DEVICE_PNP_CAPABILITIES_INIT(&pnpCaps);
    pnpCaps.SurpriseRemovalOK = WdfTrue;

    WdfDeviceSetPnpCapabilities(device, &pnpCaps);

    WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE(&ioQueueConfig, WdfIoQueueDispatchParallel);

    ioQueueConfig.EvtIoRead = EvtIoRead;
    ioQueueConfig.EvtIoWrite = EvtIoWrite;
    ioQueueConfig.EvtIoDeviceControl = EvtIoDeviceControl;
    ioQueueConfig.PowerManaged = WdfTrue;

    status = WdfIoQueueCreate(device, &ioQueueConfig, WDF_NO_OBJECT_ATTRIBUTES, &queue);
    if (!NT_SUCCESS(status)) {
        DbgPrint("WdfIoQueueCreate failed  %!STATUS!\n", status);
        return status;
    }
    pDevContext->DeviceIOControlQueue = queue;

    status = WdfDeviceCreateDeviceInterface(device, (LPGUID) &GUID_DEVINTERFACE_MYDEVICE, NULL);

    if (!NT_SUCCESS(status)) {
        DbgPrint("WdfDeviceCreateDeviceInterface failed  %!STATUS!\n", status);
        return status;
    }
}

我从哪里开始？有什么好的例子吗？

Answer 1

对于所有连接的设备，内存中只有一个驱动程序实例（它是单例）。操作系统对驱动程序的调用伴随着相关的设备上下文，从那时起，设备不应干扰彼此的操作。如果使用非常量全局/静态变量，就会出现问题。由于内核空间是共享的，因此这些变量实际上将被所有连接的设备共享和访问。因此，全局/静态数据不应该是特定于设备的，并且应该受到保护，因为它是共享资源。 WDK 中有一些演示多设备驱动程序的示例。