Função RtlFindLongestRunClear (wdm.h)

Artigo
02/27/2024

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

Sintaxe

NTSYSAPI ULONG RtlFindLongestRunClear(
  [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 mais longa e clara no bitmap é retornado. Esse é um valor baseado em zero que indica a posição do bit do primeiro bit claro no intervalo retornado.

Retornar valor

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

Comentários

Uma execução retornada pode ter um único bit claro.

Os chamadores de RtlFindLongestRunClear 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, RtlFindLongestRunClear 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)