Поделиться через


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

См. также раздел

RTL_BITMAP

RtlAreBitsClear

RtlFindClearBits

RtlFindClearRuns

RtlFindFirstRunClear

RtlFindLastBackwardRunClear

RtlFindLongestRunClear

RtlFindNextForwardRunClear

RtlInitializeBitMap

RtlNumberOfClearBits

RtlSetBits