Поделиться через


Функция 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 равен нулю, RtlClearBits просто возвращает элемент управления без очистки битов.

Сумма (StartingIndex + NumberToClear) не должна превышать значение параметра SizeOfBitMap , указанное в вызове RtlInitializeBitMap , который инициализировал растровое изображение.

Вызывающие элементы RtlClearBits должны выполняться в irQL <= APC_LEVEL, если память, содержащая растровое изображение, является страничной или память BitMapHeader является страничной. В противном случае RtlClearBits можно вызвать в любом irQL.

Требования

Требование Значение
Минимальная версия клиента Доступно начиная с Windows 2000.
Целевая платформа Универсальное
Верхняя часть wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h)
Библиотека NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL (см. раздел "Примечания".)

См. также раздел

RTL_BITMAP

RtlAreBitsSet

RtlClearAllBits

RtlFindSetBits

RtlFindSetBitsAndClear

RtlInitializeBitMap

RtlNumberOfSetBits