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) |