次の方法で共有

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
ヘッダー wdfrequest.h (Wdf.h を含む)
ライブラリ Wdf01000.sys (KMDF);WUDFx02000.dll (UMDF)
IRQL <=DISPATCH_LEVEL
DDI コンプライアンス規則 を する DriverCreate(kmdf), InvalidReqAccess(kmdf), InvalidReqAccessLocal(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

関連項目

WdfRequestCompleteWithInformation の

WdfRequestSetInformation の