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

Статья
02/27/2024

Подпрограмма RtlFindClearBitsAndSet ищет диапазон четких битов запрошенного размера в растровом рисунке и задает все биты в диапазоне, когда он был найден.

Синтаксис

NTSYSAPI ULONG RtlFindClearBitsAndSet(
  [in] PRTL_BITMAP BitMapHeader,
  [in] ULONG       NumberToFind,
  [in] ULONG       HintIndex
);

Параметры

[in] BitMapHeader

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

[in] NumberToFind

Указывает, сколько непрерывных чистых битов будет удовлетворять этому запросу.

[in] HintIndex

Задает отсчитываемую от нуля позицию бита, с которой начинается поиск четкого битового диапазона заданного размера.

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

RtlFindClearBitsAndSet либо возвращает отсчитываемый от нуля начальный битовый индекс для четко заданного диапазона битов запрошенного размера, либо возвращает 0xFFFFFFFF, если не удается найти такой диапазон в заданной переменной растрового изображения.

Для успешного вызова возвращаемая битовая позиция не обязательно эквивалентна заданному элементу HintIndex. При необходимости RtlFindClearBitsAndSet выполняет поиск по всему растровом рисунку, чтобы найти четкий битовый диапазон запрошенного размера. Однако он начинает поиск запрошенного диапазона из HintIndex, поэтому вызывающие абоненты могут быстрее сбросить этот диапазон, когда они могут предоставить соответствующие подсказки о том, с чего начать поиск.

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

Требования

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