WDF_IO_QUEUE_DRAINED関数 (wdfio.h)

[KMDF と UMDF に適用]

WDF_IO_QUEUE_DRAINED 関数は、I/O キューの状態がキューがドレインされていることを示す場合、TRUE を返します。

構文

BOOLEAN WDF_IO_QUEUE_DRAINED(
  [in] WDF_IO_QUEUE_STATE State
);

パラメーター

[in] State

WdfIoQueueGetState が返 WDF_IO_QUEUE_STATE型指定された値。

戻り値

WDF_IO_QUEUE_DRAINED は、指定 キューの状態がキューがドレインされていることを示す場合に TRUE を返します。それ以外の場合、関数は FALSE 返します。

注釈

I/O キューは、新しい I/O 要求を受け入れていなくても、キュー内のすべての要求がドライバーに配信された場合にドレインされます。

ドライバーは、WdfIoQueueGetState 呼び出した後、WDF_IO_QUEUE_DRAINED を呼び出すことができます。

I/O キューの状態の詳細については、WDF_IO_QUEUE_STATEを参照してください。

例示

次のコード例は、指定した I/O キューがドレイン 場合に TRUE を返すルーチンです。

BOOLEAN
IsQueueDrained(
    IN WDFQUEUE Queue
    )
{
    WDF_IO_QUEUE_STATE queueStatus;
    queueStatus = WdfIoQueueGetState(
                                     Queue,
                                     NULL,
                                     NULL
                                     );
    return (WDF_IO_QUEUE_DRAINED(queueStatus)) ? TRUE : FALSE;
}

必要条件

要件	価値
ターゲットプラットフォームの	普遍
最小 KMDF バージョン	1.0
ヘッダー	wdfio.h (Wdf.h を含む)
図書館	なし
IRQL	任意の IRQL。