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

Статья
02/27/2024

Подпрограмма RtlFindLongestRunClear ищет самый большой непрерывный диапазон четких битов в пределах заданного растрового изображения.

Синтаксис

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

Параметры

[in] BitMapHeader

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

[out] StartingIndex

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

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

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

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

Требования

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