Função FsRtlLookupLastLargeMcbEntryAndIndex (ntifs.h)

Artigo
02/26/2024

A rotina FsRtlLookupLastLargeMcbEntryAndIndex recupera a última entrada de mapeamento armazenada em um determinado bloco de controle de mapa (MCB).

Sintaxe

BOOLEAN FsRtlLookupLastLargeMcbEntryAndIndex(
  [in]  PLARGE_MCB OpaqueMcb,
  [out] PLONGLONG  LargeVbn,
  [out] PLONGLONG  LargeLbn,
  [out] PULONG     Index
);

Parâmetros

[in] OpaqueMcb

Ponteiro para uma estrutura do MCB inicializada a ser pesquisada.

[out] LargeVbn

Ponteiro para uma variável que recebe o último número de bloco virtual (VBN) que foi mapeado.

[out] LargeLbn

Ponteiro para uma variável que recebe o LBN (número de bloco lógico) mapeado para o VBN apontado por LargeVbn ou -1 se não existir tal LBN.

[out] Index

Ponteiro para uma variável que recebe o índice da última execução no MCB.

Retornar valor

FsRtlLookupLastLargeMcbEntryAndIndex retornará FALSE se o MCB não contiver nenhuma entrada de mapeamento, caso contrário, FALSE.

Comentários

FsRtlLookupLastLargeMcbEntryAndIndex pesquisa o último mapeamento da última execução no MCB:

Se o MCB não contiver mapeamentos, FsRtlLookupLastLargeMcbEntryAndIndex retornará FALSE.
Se o último mapeamento for um buraco, FsRtlLookupLastLargeMcbEntryAndIndex retornará FALSE, mas a operação de pesquisa produzirá um valor de -1 para o LBN.
Se o último mapeamento não for um buraco, a operação de pesquisa produzirá um valor positivo para o LBN e FsRtlLookupLastLargeMcbEntryAndIndex retornará FALSE.

Os 32 bits superiores do LBN são ignorados. Somente os 32 bits inferiores são usados.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP
Plataforma de Destino	Universal
Cabeçalho	ntifs.h (inclua Ntifs.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL