学习windows驱动(设备对象设备栈)

IO相关的操作是围绕设备对象进行的。

设备对象分下几类：
1、功能设备对象(FDO): 功能驱动为设备创建一个FDO，在设备栈里它位于物理设备(PDO)的上层。

2、物理设备对象(PDO): 总线驱动创建PDO，逻辑上代表物理设备本身，功能设备对象(FDO)代表系统对这个PDO做的处理。FDO为什么会被总线驱动创建？是因为FDO代表的物理设备连接到此总线设备上，总线驱动起了承担总线设备的功能驱动作用。

3.过滤设备对象(Filter DO):

4、控制设备对象(CDO): 它一般不存在设备栈里，而是一个独立的设备.这个设备用作用户程序接口，用户程序通过CreateFile将它打开，通过它发送IO请求给驱动处理。用户程序通过CDO对内核驱动实现控制。

可以通过WdfDeviceSetXXX、WdfDeviceInitXXX系列函数来设置设备对象属性，通过WdfDeviceGetXXX系列函数来获取设备对象属性。

那么怎么创建设备对象呢？
PNP类驱动在EvtDriverDeviceAdd事件里创建设备，
下面是创建设备对象的代码示例：

typedef struct _FDO_CONTEXT_SPACE
{
    WDFDEVICE               WdfDevice;       // 设备对象
    WDFQUEUE                ReadQueue;       // 读请求队列
    WDFQUEUE                WriteQueue;      // 写请求队列
    WDFQUEUE                IoctlQueue;      // 控制请求队列
}FDO_CONTEXT_SPACE, *PFDO_CONTEXT_SPACE;

EVT_WDF_DEVICE_PREPARE_HARDWARE EvtDevicePrepareHardware;
EVT_WDF_DEVICE_RELEASE_HARDWARE EvtDeviceReleaseHardware;
EVT_WDF_INTERRUPT_ISR EvtInterruptIsr;
EVT_WDF_INTERRUPT_DPC EvtInterruptDpc;
EVT_WDF_INTERRUPT_ENABLE EvtInterruptEnable;
EVT_WDF_DEVICE_D0_ENTRY_POST_INTERRUPTS_ENABLED EvtDeviceD0EntryPostInterruptsEnabled;
EVT_WDF_DEVICE_D0_EXIT_PRE_INTERRUPTS_DISABLED EvtDeviceD0ExitPreInterruptsDisabled;
EVT_WDF_INTERRUPT_DISABLE EvtInterruptDisable;

WDF_DECLARE_CONTEXT_TYPE_WITH_NAME(FDO_CONTEXT_SPACE, FdoGetContextSpace)

VOID EvtDeviceContextCleanup(
    IN WDFDEVICE Device
)
/*++
描述：设备对象被删除时会回调该例程
--*/
{
    //do somethin....
}

NTSTATUS EvtDriverDeviceAdd(
    IN WDFDRIVER Driver,
    IN PWDFDEVICE_INIT DeviceInit
)
/*++
描述：添加设备对象的事件回调函数
--*/
{
    NTSTATUS status;
    WDF_PNPPOWER_EVENT_CALLBACKS pnpPowerCallbacks;
    WDF_OBJECT_ATTRIBUTES attributes;
    WDFDEVICE device;
    PFDO_CONTEXT_SPACE fdoContextSpace;

    PAGED_CODE();
    UNREFERENCED_PARAMETER(Driver);

    // 直接访问方式
    WdfDeviceInitSetIoType(DeviceInit, WdfDeviceIoDirect);

    // 即插即用和电源管理
    WDF_PNPPOWER_EVENT_CALLBACKS_INIT(&pnpPowerCallbacks);
    pnpPowerCallbacks.EvtDevicePrepareHardware = EvtDevicePrepareHardware;
    pnpPowerCallbacks.EvtDeviceReleaseHardware = EvtDeviceReleaseHardware;
    pnpPowerCallbacks.EvtDeviceD0Entry = EvtDeviceD0Entry;
    pnpPowerCallbacks.EvtDeviceD0Exit = EvtDeviceD0Exit;
    pnpPowerCallbacks.EvtDeviceD0EntryPostInterruptsEnabled = EvtDeviceD0EntryPostInterruptsEnabled;
    pnpPowerCallbacks.EvtDeviceD0ExitPreInterruptsDisabled = EvtDeviceD0ExitPreInterruptsDisabled;
    WdfDeviceInitSetPnpPowerEventCallbacks(DeviceInit, &pnpPowerCallbacks);
    // 允许同时打开多个句柄
    WdfDeviceInitSetExclusive (DeviceInit, FALSE);

     WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&attributes, FDO_CONTEXT_SPACE);
     attributes.EvtCleanupCallback = EvtDeviceContextCleanup;
     status = WdfDeviceCreate(&DeviceInit, &attributes, &device);
     if (!NT_SUCCESS(status))
    {
        TraceEvents(TRACE_LEVEL_ERROR, DBG_PNP, "WdfDeviceCreate failed status=0x%08x", status);
        return status;
    }

    //do something ...
    TraceEvents(TRACE_LEVEL_INFORMATION, DBG_PNP, "%s leave", __FUNCTION__);
    return status;
}

 

设备栈

下面以一个简单图示，来直观感觉一下什么是设备栈：

IRP在设备栈中一层一层的自上而下的传递。
IRP进入WDF驱动后，设备对象会把IRP封装成WDF IO请求对象WDFREQUEST，送给WDF设备WDFDEVICE处理；
处理完成，WDF设备对象再从WDFREQUEST对象里提取IRP,
把IRP传递到设备栈里的下一层。