RtlFindFirstRunClear 関数 (wdm.h)

[アーティクル]
02/14/2024

RtlFindFirstRunClear ルーチンは、特定のビットマップ内のクリアビットの最初の連続した範囲を検索します。

構文

NTSYSAPI ULONG RtlFindFirstRunClear(
  [in]  PRTL_BITMAP BitMapHeader,
  [out] PULONG      StartingIndex
);

パラメーター

[in] BitMapHeader

ビットマップを記述する RTL_BITMAP 構造体へのポインター。この構造体は、RtlInitializeBitMap ルーチンによって初期化されている必要があります。

[out] StartingIndex

ビットマップ内の最初のクリア実行の開始インデックスが返される変数へのポインター。これは、返される範囲内の最初のクリアビットのビット位置を示す 0 から始まる値です。 RtlFindFirstRunClear でクリアビットの実行が見つからない場合、その値は意味がありません。

戻り値

RtlFindFirstRunClear は、 StartingIndex で始まる実行のビット数を返し、ビットマップ内でクリアビットの実行が見つからない場合は 0 を返します。

注釈

返される実行は、1 つのクリアビットを持つことができます。つまり、クリアビットが見つかったら、 RtlFindFirstRunClear は、次のセットビットが見つかるまで検索を続け、検出された実行でクリアビットの数を返します。

ビットマップ変数を含むメモリがページング可能であるか、BitMapHeader のメモリがページング可能な場合、RtlFindFirstRunClear の呼び出し元は IRQL <= APC_LEVELで実行されている必要があります。それ以外の場合は、任意の IRQL で RtlFindFirstRunClear を呼び出すことができます。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 以降で使用できます。
対象プラットフォーム	ユニバーサル
Header	wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
Library	NtosKrnl.lib
[DLL]	NtosKrnl.exe
IRQL	<= APC_LEVEL (「解説」セクションを参照)