RtlClearBits 関数 (wdm.h)

[アーティクル]
08/08/2023

RtlClearBits ルーチンは、ビットマップ内の指定されたビット範囲のすべてのビットをゼロに設定します。

構文

NTSYSAPI VOID RtlClearBits(
  [in] PRTL_BITMAP BitMapHeader,
  [in] ULONG       StartingIndex,
  [in] ULONG       NumberToClear
);

パラメーター

[in] BitMapHeader

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

[in] StartingIndex

クリアするビット範囲内の最初のビットのインデックス。ビットマップに N ビットが含まれている場合、ビットには 0 から N-1 の番号が付けられます。

[in] NumberToClear

クリアするビット数を指定します。ビットマップに N ビットが含まれている場合、このパラメーターには 1 ~ (N - StartingIndex) の範囲の値を指定できます。

戻り値

このルーチンは値を返しません。

注釈

NumberToClear パラメーターが 0 の場合、RtlClearBits は単にビットをクリアせずにコントロールを返します。

合計 (StartingIndex + NumberToClear) は、ビットマップを初期化した RtlInitializeBitMap 呼び出しで指定された SizeOfBitMap パラメーター値を超えてはなりません。

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

要件

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