Função RtlFindNextForwardRunClear (wdm.h)

Artigo
03/01/2024

A rotina RtlFindNextForwardRunClear pesquisa uma determinada variável de bitmap para a próxima execução clara de bits, começando pela posição de índice especificada.

Sintaxe

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

Parâmetros

[in] BitMapHeader

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

[in] FromIndex

Especifica uma posição de bit baseada em zero na qual começar a procurar uma execução clara de bits.

[out] StartingRunIndex

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

Retornar valor

RtlFindNextForwardRunClear retorna o número de bits na execução começando em StartingRunIndex ou zero se não conseguir encontrar uma execução de bits claros após FromIndex no bitmap.

Comentários

Os chamadores de RtlFindNextForwardRunClear 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, RtlFindNextForwardRunClear 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 (consulte a seção Comentários)