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

Статья
02/27/2024

Подпрограмма RtlAreBitsClear определяет, является ли заданный диапазон битов в переменной растрового изображения ясным.

Синтаксис

NTSYSAPI BOOLEAN RtlAreBitsClear(
  [in] PRTL_BITMAP BitMapHeader,
  [in] ULONG       StartingIndex,
  [in] ULONG       Length
);

Параметры

[in] BitMapHeader

Указатель на структуру RTL_BITMAP , описывающую растровое изображение. Эта структура должна быть инициализирована подпрограммой RtlInitializeBitMap .

[in] StartingIndex

Указывает начало проверяемого битового диапазона. Это отсчитываемое от нуля значение, указывающее положение первого бита в диапазоне.

[in] Length

Указывает, сколько битов требуется проверить.

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

Функция RtlAreBitsClear возвращает значение TRUE , если последовательные биты Length , начинающиеся с StartingIndex , ясны (то есть все биты от StartingIndex до (StartingIndex + Length) -1). Он возвращает значение FALSE , если задан какой-либо бит в заданном диапазоне, если данный диапазон не является правильным подмножеством растрового изображения или если заданная длина равна нулю.

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

Требования

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