WDF_IO_QUEUE_IDLE関数 (wdfio.h)
[KMDF と UMDF に適用]
WDF_IO_QUEUE_IDLE関数は、I/O キューの状態がキューがドレインされていることを示す場合に TRUE を返します。
構文
BOOLEAN WDF_IO_QUEUE_IDLE(
[in] WDF_IO_QUEUE_STATE State
);
パラメーター
[in] State
WdfIoQueueGetState が返すWDF_IO_QUEUE_STATE型指定された値。
戻り値
指定 したキューの状態がキューがアイドル状態であることを示す場合、WDF_IO_QUEUE_IDLEは TRUE を 返します。 それ以外の場合、関数は FALSE を返します。
注釈
キューに I/O 要求が含まれない場合、および配信されたすべての要求が完了または取り消された場合、I/O キューはアイドル状態になります。
ドライバーは、WdfIoQueueGetState を呼び出した後、WDF_IO_QUEUE_IDLEを呼び出すことができます。
I/O キューの状態の詳細については、「 WDF_IO_QUEUE_STATE」を参照してください。
例
次のコード例は、指定された I/O キューがアイドル状態の場合 に TRUE を 返すルーチンです。
BOOLEAN
IsQueueIdle(
IN WDFQUEUE Queue
)
{
WDF_IO_QUEUE_STATE queueStatus;
queueStatus = WdfIoQueueGetState(
Queue,
NULL,
NULL
);
return (WDF_IO_QUEUE_IDLE(queueStatus)) ? TRUE : FALSE;
}
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | ユニバーサル |
| 最小 KMDF バージョン | 1.0 |
| Header | wdfio.h (Wdf.h を含む) |
| Library | なし |
| IRQL | 任意の IRQL。 |