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传递到设备栈里的下一层。