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

Статья
02/29/2024

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

Синтаксис

NTSYSAPI ULONG RtlFindFirstRunClear(
  [in]  PRTL_BITMAP BitMapHeader,
  [out] PULONG      StartingIndex
);

Параметры

[in] BitMapHeader

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

[out] StartingIndex

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

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

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

Возвращаемое выполнение может содержать один четкий бит. То есть после обнаружения чистого бита RtlFindFirstRunClear продолжает поиск до тех пор, пока не найдет следующий заданный бит, а затем возвращает количество чистых битов в обнаруженном выполнении.

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

Требования

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