WdfRequestIsReserved 関数 (wdfrequest.h)
[KMDF にのみ適用]
WdfRequestIsReserved メソッドは、指定された要求オブジェクトが、メモリ不足の状況での転送の保証された進行状況をサポートするためにフレームワークが予約した要求オブジェクトであるかどうかを判断します。
構文
BOOLEAN WdfRequestIsReserved(
[in] WDFREQUEST Request
);
パラメーター
[in] Request
フレームワーク要求オブジェクトへのハンドル。
戻り値
WdfRequestIsReserved は、指定された要求オブジェクトがメモリ不足の状況に対してフレームワークが事前に割り当てた要求オブジェクトである場合に TRUE を 返します。 それ以外の場合、メソッドは FALSE を返します。
注釈
WdfRequestIsReserved メソッドの詳細については、「I/O 操作の前方進行状況の保証」を参照してください。
例
次のコード例では、ドライバーの EvtIoRead コールバック関数が受信した要求オブジェクトが、メモリ不足の状況でドライバーが作成した要求オブジェクトであるかどうかを判断します。
VOID
MyIoRead (
IN WDFQUEUE Queue,
IN WDFREQUEST Request,
IN size_t Length
)
{...
if (WdfRequestIsReserved(Request)) {
// Low memory situation exists.
...
}
else {
// Low memory situation does not exist.
...
}
...}
要件
要件 | 値 |
---|---|
対象プラットフォーム | ユニバーサル |
最小 KMDF バージョン | 1.9 |
Header | wdfrequest.h (Wdf.h を含む) |
Library | Wdf01000.sys (「Framework ライブラリのバージョン管理」を参照)。 |
IRQL | <=DISPATCH_LEVEL |
DDI コンプライアンス規則 | DriverCreate(kmdf) |