RtlFindClearRuns 関数 (wdm.h)

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

RtlFindClearRuns ルーチンは、指定されたビットマップ内のクリアビットの指定された実行数を検索します。

構文

NTSYSAPI ULONG RtlFindClearRuns(
  [in]  PRTL_BITMAP     BitMapHeader,
  [out] PRTL_BITMAP_RUN RunArray,
  [in]  ULONG           SizeOfRunArray,
  [in]  BOOLEAN         LocateLongestRuns
);

パラメーター

[in] BitMapHeader

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

[out] RunArray

指定されたビットマップ変数で見つかった各クリア実行のビット位置と長さについて、呼び出し元によって割り当てられた配列内の最初の要素へのポインター。

[in] SizeOfRunArray

この要求を満たすクリア実行の最大数を指定します。

[in] LocateLongestRuns

TRUE の場合、ルーチンはビットマップ全体を検索して、見つけることができる最も長いクリア実行を検索することを指定します。それ以外の場合、 SizeOfRunArray で指定されたクリア実行の数が見つかると、ルーチンの検索が停止します。

戻り値

RtlFindClearRuns は、 検出されたクリア実行の数を返します。

注釈

LocateLongestRuns が TRUE の場合、RunArray で示される明確な実行は最長から最短に並べ替えられます。明確な実行は、1 つのビットで構成できます。

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

要件

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