次の方法で共有

WdfRequestGetStatus 関数 (wdfrequest.h)

  • [アーティクル]

[KMDF と UMDF に適用]

WdfRequestGetStatus メソッドは、I/O 要求の状態を返します。

構文

NTSTATUS WdfRequestGetStatus(
  [in] WDFREQUEST Request
);

パラメーター

[in] Request

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

戻り値

WdfRequestGetStatus は NTSTATUS 値を返します。 返される値の詳細については、次の「解説」セクションを参照してください。

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

備考

WdfRequestGetStatus メソッドは、次のいずれかを返します。

  • WdfRequestSend を するドライバーの呼び出しが成功した場合、WdfRequestGetStatus は、指定された要求を完了するために WdfRequestComplete を呼び出すドライバーによって設定された状態値を返します。 ドライバーは通常、CompletionRoutine コールバック関数内から WdfRequestGetStatus を呼び出します。
  • WdfRequestSend を するドライバーの呼び出しが失敗した場合、WdfRequestGetStatus は、フレームワークがエラーを説明するために設定した状態値を返します。 ドライバーは、WdfRequestSend 呼び出した直後に、WdfRequestGetStatus を呼び出すことができます。
WdfRequestSend を呼び出すときに、ドライバーが要求の WDF_REQUEST_SEND_OPTION_SYNCHRONOUS フラグ設定した場合、ドライバーは WdfRequestSend 呼び出した直後 WdfRequestGetStatus を呼び出すことができます WdfRequestSend の呼び出しが成功または失敗したかどうか。

要求の完了の詳細については、「I/O 要求の完了」を参照してください。

例

次のコード例は、KbFiltr サンプル ドライバーのコード例です。 この例では、I/O 要求を I/O ターゲットに送信します。 WdfRequestSend 失敗した場合、この例では、WdfRequestGetStatus 戻り値を入力として使用して WdfRequestComplete します。

VOID
KbFilter_ForwardRequest(
    IN WDFREQUEST Request,
    IN WDFIOTARGET Target
    )
{
    WDF_REQUEST_SEND_OPTIONS options;
    BOOLEAN ret;
    NTSTATUS status;

    WDF_REQUEST_SEND_OPTIONS_INIT(
                                  &options,
                                  WDF_REQUEST_SEND_OPTION_SEND_AND_FORGET
                                  );

    ret = WdfRequestSend(
                         Request,
                         Target,
                         &options
                         );

    if (ret == FALSE) {
        status = WdfRequestGetStatus (Request);
        DebugPrint(("WdfRequestSend failed: 0x%x\n", status));
        WdfRequestComplete(
                           Request,
                           status
                           );
    }
    return;
}

必要条件

要件 価値
ターゲット プラットフォーム の 万国
最小 KMDF バージョン 1.0
UMDF の最小バージョン を する 2.0
ヘッダー wdfrequest.h (Wdf.h を含む)
ライブラリ Wdf01000.sys (KMDF);WUDFx02000.dll (UMDF)
IRQL <=DISPATCH_LEVEL
DDI コンプライアンス規則 を する DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), RequestGetStatusValid(kmdf)

関連項目

CompletionRoutine

WdfRequestComplete

WdfRequestSend