WdfRequestRequeue 関数 (wdfrequest.h)

[KMDF と UMDF に適用]

WdfRequestRequeue メソッドは、ドライバーに配信された I/O キューの先頭に I/O 要求を返します。

構文

NTSTATUS WdfRequestRequeue(
  [in] WDFREQUEST Request
);

パラメーター

[in] Request

フレームワーク要求オブジェクトへのハンドル。

戻り値

操作が成功した場合、WdfRequestRequeue はSTATUS_SUCCESSを返します。 それ以外の場合、このメソッドは次のいずれかの値を返す可能性があります。

このメソッドは、他の NTSTATUS 値も返す場合があります。

ドライバーが無効なオブジェクト ハンドルを提供すると、バグ チェックが発生します。

注釈

ドライバーは、I/O キューの手動ディスパッチ メソッドを使用している場合にのみ WdfRequestRequeue を呼び出すことができます。

WdfIoQueuePurge を呼び出した後にドライバーが WdfRequestRequeue を呼び出した場合、消去が完了する前にリキュー試行が成功する可能性があります。 バージョン 1.9 以前の KMDF では、このシーケンスによってオペレーティング システムがクラッシュします。 この問題は、KMDF バージョン 1.11 以降で修正されています。

WdfRequestRequeue の詳細については、「I/O 要求の再キュー」を参照してください。

例

次のコード例では、ドライバーが要求を受信したキューに指定された I/O 要求を返します。

NTSTATUS status;

status = WdfRequestRequeue(request);

要件