[适用于 KMDF 和 UMDF]
驱动程序的 EvtIoQueueState 事件回调函数将队列状态信息传递到驱动程序。
语法
EVT_WDF_IO_QUEUE_STATE EvtWdfIoQueueState;
void EvtWdfIoQueueState(
[in] WDFQUEUE Queue,
[in] WDFCONTEXT Context
)
{...}
参数
[in] Queue
I/O 队列对象的句柄。
[in] Context
驱动程序定义的上下文信息,驱动程序在注册 EvtIoQueueState 回调函数时指定的上下文信息。
返回值
没有
注解
驱动程序可以通过将地址指定为 WdfIoQueueStop、WdfIoQueueDrain、WdfIoQueuePurge或 WdfIoQueueReadyNotify来注册 EvtIoQueueState 回调函数。 框架在指定作完成后调用 EvtIoQueueState 回调函数。
可以在 IRQL <= DISPATCH_LEVEL 调用 EvtIoQueueState 回调函数,除非队列 WDF_OBJECT_ATTRIBUTES 的 ExecutionLevel 成员设置为 WdfExecutionLevelPassive,在这种情况下,该函数在 IRQL = PASSIVE_LEVEL 调用。 如果队列指定 WdfExecutionLevelInheritFromParent,则可以从 WDFDEVICE 或 WDFDRIVER 的 WDF_OBJECT_ATTRIBUTES继承该属性。
如果 IRQL PASSIVE_LEVEL,则框架会在 关键区域调用回调函数。
要求
要求 | 价值 |
---|---|
目标平台 | 普遍 |
最低 KMDF 版本 | 1.0 |
最低 UMDF 版本 | 2.0 |
标头 | wdfio.h (包括 Wdf.h) |
IRQL | <= DISPATCH_LEVEL (请参阅“备注”部分) |