EVT_WDF_IO_QUEUE_STATE回呼函式 (wdfio.h)

發行項
02/27/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 回呼函式。

除非佇列WDF_OBJECT_ATTRIBUTES的ExecutionLevel 成員設定為 WdfExecutionLevelPassive，否則可以在 IRQL <= DISPATCH_LEVEL呼叫 EvtIoQueueState 回呼函式，在此情況下，它會在 IRQL = PASSIVE_LEVEL呼叫。如果佇列指定 WdfExecutionLevelInheritFromParent，則可以繼承屬性自 WDFDEVICE 或 WDFDRIVER 的 WDF_OBJECT_ATTRIBUTES。

如果 IRQL PASSIVE_LEVEL，架構會呼叫重要區域內的回呼函式。