RtlFindClearRuns 関数 (wdm.h)
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 (「解説」セクションを参照) |