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。

こちらもご覧ください

WDF_IO_QUEUE_DRAINED

WDF_IO_QUEUE_PURGED

WDF_IO_QUEUE_READY

WDF_IO_QUEUE_STOPPED