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 コールバック関数を登録したときに指定したドライバー定義のコンテキスト情報。
戻り値
なし
解説
ドライバーは、そのアドレスを WdfIoQueueStop、WdfIoQueueDrain、WdfIoQueuePurge、または WdfIoQueueReadyNotify への入力として指定することで、EvtIoQueueState コールバック関数を登録できます。 フレームワークは、指定した操作の完了後 に EvtIoQueueState コールバック関数を呼び出します。
キューのWDF_OBJECT_ATTRIBUTESの ExecutionLevel メンバーが WdfExecutionLevelPassive に設定されていない限り、EvtIoQueueState コールバック関数は IRQL = DISPATCH_LEVELで呼<び出すことができます。この場合は IRQL = PASSIVE_LEVEL で呼び出されます。 キューで WdfExecutionLevelInheritFromParent が指定されている場合、プロパティは WDFDEVICE または WDFDRIVER の WDF_OBJECT_ATTRIBUTESから継承できます。
IRQL がPASSIVE_LEVELされている場合、フレームワークは 重要なリージョン内でコールバック関数を呼び出します。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | ユニバーサル |
| 最小 KMDF バージョン | 1.0 |
| 最小 UMDF バージョン | 2.0 |
| Header | wdfio.h (Wdf.h を含む) |
| IRQL | <= DISPATCH_LEVEL (「解説」セクションを参照) |