Функция 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 (см. раздел "Примечания".) |