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

Статья
02/27/2024

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

Синтаксис

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

Параметры

[in] BitMapHeader

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

[in] NumberToFind

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

[in] HintIndex

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

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

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

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

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

Если требуется возвращать только индекс, который больше или равен некоторому значению, используйте вместо него RtlFindNextForwardRunClear .

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

Требования

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