WdfRequestGetInformation 関数 (wdfrequest.h)

  • [アーティクル]

[KMDF と UMDF に適用]

WdfRequestGetInformation メソッドは、指定された I/O 要求の完了状態情報を返します。

構文

ULONG_PTR WdfRequestGetInformation(
  [in] WDFREQUEST Request
);

パラメーター

[in] Request

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

戻り値

WdfRequestGetInformation は、WdfRequestSetInformation または WdfRequestCompleteWithInformation を呼び出すことによって、下位レベルのドライバーが設定した情報を返します。

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

注釈

ドライバーは 、WdfRequestSetInformation または WdfRequestCompleteWithInformation を呼び出して、I/O 要求の完了状態情報を設定できます。 ドライバーは、下位レベルのドライバーが要求を完了した後 に WdfRequestGetInformation を呼び出して、下位レベルのドライバーが設定した完了状態情報を取得できます。

ドライバーが WdfRequestComplete を呼び出して要求を完了した後に WdfRequestGetInformation を呼び出すと、 WdfRequestGetInformation はNULL を返します。

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

例

次のコード例では、I/O 要求を I/O ターゲットに送信し、I/O ターゲットが提供した状態情報を取得します。

ULONG_PTR  informationRetrieved = NULL;

status = WdfIoTargetSendWriteSynchronously(
                                           ioTarget,
                                           request,
                                           &outputMemoryDescriptor,
                                           NULL,
                                           NULL,
                                           &bytesWritten
                                           );
if (NT_SUCCESS(status)) {
    informationRetrieved = WdfRequestGetInformation(request);
}

要件

要件 値
対象プラットフォーム ユニバーサル
最小 KMDF バージョン 1.0
最小 UMDF バージョン 2.0
Header wdfrequest.h (Wdf.h を含む)
Library Wdf01000.sys (KMDF);WUDFx02000.dll (UMDF)
IRQL <=DISPATCH_LEVEL
DDI コンプライアンス規則 DriverCreate(kmdf)、 InvalidReqAccess(kmdf)、 InvalidReqAccessLocal(kmdf)、 KmdfIrql(kmdf)、 KmdfIrql2(kmdf)、KmdfIrqlExplicit(kmdf)

こちらもご覧ください

WdfRequestCompleteWithInformation

WdfRequestSetInformation