EVT_WDF_IO_QUEUE_STATE回调函数 (wdfio.h)

项目
02/29/2024

[适用于 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，框架会在关键区域内调用回调函数。