EVT_WDF_IO_QUEUE_STATE回调函数 (wdfio.h)

[适用于 KMDF 和 UMDF]

驱动程序的 EvtIoQueueState 事件回调函数将队列状态信息传递到驱动程序。

语法

EVT_WDF_IO_QUEUE_STATE EvtWdfIoQueueState;

void EvtWdfIoQueueState(
  [in] WDFQUEUE Queue,
  [in] WDFCONTEXT Context
)
{...}

参数

[in] Queue

I/O 队列对象的句柄。

[in] Context

驱动程序定义的上下文信息,驱动程序在注册 EvtIoQueueState 回调函数时指定的上下文信息。

返回值

没有

注解

驱动程序可以通过将地址指定为 WdfIoQueueStopWdfIoQueueDrainWdfIoQueuePurgeWdfIoQueueReadyNotify来注册 EvtIoQueueState 回调函数。 框架在指定作完成后调用 EvtIoQueueState 回调函数。

可以在 IRQL <= DISPATCH_LEVEL 调用 EvtIoQueueState 回调函数,除非队列 WDF_OBJECT_ATTRIBUTESExecutionLevel 成员设置为 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 (请参阅“备注”部分)

另请参阅

WDF_OBJECT_ATTRIBUTES

WdfIoQueueDrain

WdfIoQueuePurge

WdfIoQueueReadyNotify

WdfIoQueueStop