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)

こちらもご覧ください

WdfIoQueueAssignForwardProgressPolicy