Função RtlFindFirstRunClear (wdm.h)

A rotina RtlFindFirstRunClear pesquisa o intervalo contíguo inicial de bits claros em um determinado bitmap.

Sintaxe

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

Parâmetros

[in] BitMapHeader

Um ponteiro para a estrutura RTL_BITMAP que descreve o bitmap. Essa estrutura deve ter sido inicializada pela rotina RtlInitializeBitMap .

[out] StartingIndex

Ponteiro para uma variável na qual o índice inicial da execução clara inicial no bitmap é retornado. Esse é um valor baseado em zero que indica a posição do bit do primeiro bit claro no intervalo retornado. Seu valor não tem sentido se RtlFindFirstRunClear não conseguir encontrar uma execução de bits claros.

Retornar valor

RtlFindFirstRunClear retorna o número de bits na execução começando em StartingIndex ou zero se não encontrar uma execução de bits claros dentro do bitmap.

Comentários

Uma execução retornada pode ter um único bit claro. Ou seja, depois que um bit claro é encontrado, RtlFindFirstRunClear continua pesquisando até encontrar o bit do próximo conjunto e retorna o número de bits claros na execução encontrada.

Os chamadores de RtlFindFirstRunClear devem estar em execução em IRQL <= APC_LEVEL se a memória que contém a variável bitmap for paginável ou a memória em BitMapHeader for paginável. Caso contrário, RtlFindFirstRunClear pode ser chamado em qualquer IRQL.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível a partir do Windows 2000.
Plataforma de Destino Universal
Cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL (seção Consulte Comentários)

Confira também

RTL_BITMAP

RtlAreBitsClear

RtlFindClearBits

RtlFindClearRuns

RtlFindFirstRunClear

RtlFindLastBackwardRunClear

RtlFindLongestRunClear

RtlFindNextForwardRunClear

RtlInitializeBitMap

RtlNumberOfClearBits

RtlSetBits