Функция RtlFindNextForwardRunClear (wdm.h)
Подпрограмма 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 (см. раздел "Примечания") |