Função RtlFindLastBackwardRunClear (wdm.h)

Artigo
02/27/2024

A rotina RtlFindLastBackwardRunClear pesquisa um bitmap específico para a execução clara de bits anterior, começando na posição de índice especificada.

Sintaxe

NTSYSAPI ULONG RtlFindLastBackwardRunClear(
  [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 que precede o FromIndex fornecido. Seu valor não tem sentido se RtlFindLastBackwardRunClear não conseguir encontrar uma execução de bits claros.

Retornar valor

RtlFindLastBackwardRunClear retorna o número de bits na execução começando em StartingRunIndex ou zero se não encontrar uma execução de bits claros anteriores a FromIndex no bitmap.

Comentários

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