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