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

Статья
02/14/2024

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

Синтаксис

NTSYSAPI ULONG RtlFindNextForwardRunClear(
  [in]  PRTL_BITMAP BitMapHeader,
  [in]  ULONG       FromIndex,
  [out] PULONG      StartingRunIndex
);

Параметры

[in] BitMapHeader

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

[in] FromIndex

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

[out] StartingRunIndex

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

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

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

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

Требования

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