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

Статья
02/27/2024

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

Синтаксис

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

Параметры

[in] BitMapHeader

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

[in] NumberToFind

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

[in] HintIndex

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

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

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

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

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

Требования

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