Função RtlFindClearRuns (wdm.h)

Artigo
02/27/2024

A rotina RtlFindClearRuns localiza o número especificado de execuções de bits claros em um determinado bitmap.

Sintaxe

NTSYSAPI ULONG RtlFindClearRuns(
  [in]  PRTL_BITMAP     BitMapHeader,
  [out] PRTL_BITMAP_RUN RunArray,
  [in]  ULONG           SizeOfRunArray,
  [in]  BOOLEAN         LocateLongestRuns
);

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] RunArray

Ponteiro para o primeiro elemento em uma matriz alocada pelo chamador para a posição do bit e o comprimento de cada execução clara encontrada na variável bitmap fornecida.

[in] SizeOfRunArray

Especifica o número máximo de execuções claras para atender a essa solicitação.

[in] LocateLongestRuns

Se TRUE, especifica que a rotina é pesquisar todo o bitmap para obter as execuções mais longas e claras que ele pode encontrar. Caso contrário, a rotina interromperá a pesquisa quando encontrar o número de execuções claras especificadas por SizeOfRunArray.

Retornar valor

RtlFindClearRuns retorna o número de execuções claras encontradas.

Comentários

Se LocateLongestRuns for TRUE, as execuções claras indicadas em RunArray serão classificadas da mais longa para a mais curta. Uma execução clara pode consistir em um único bit.

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