RtlAreBitsClear 関数 (wdm.h)

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

RtlAreBitsClear ルーチンは、ビットマップ変数内の特定のビット範囲が明確かどうかを判断します。

構文

NTSYSAPI BOOLEAN RtlAreBitsClear(
  [in] PRTL_BITMAP BitMapHeader,
  [in] ULONG       StartingIndex,
  [in] ULONG       Length
);

パラメーター

[in] BitMapHeader

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

[in] StartingIndex

テストするビット範囲の開始を指定します。これは、範囲内の最初のビットの位置を示す 0 から始まる値です。

[in] Length

テストするビット数を指定します。

戻り値

RtlAreBitsClear は、StartingIndex で始まる連続するビットの長さが明確な場合 (つまり、StartingIndex から (StartingIndex + Length) までのすべてのビット) -1 の場合に TRUE を返します。指定された範囲のビットが設定されている場合、指定された範囲がビットマップの適切なサブセットではない場合、または指定された Length が 0 の場合は FALSE を返します。

注釈

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

要件

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