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