Функция RtlClearBits (wdm.h)

Статья
02/27/2024

Подпрограмма 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).

Возвращаемое значение

Эта подпрограмма не возвращает значение.

Вызывающие элементы 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 (см. раздел "Примечания".)