Função FsRtlGetNextLargeMcbEntry (ntifs.h)

Artigo
12/21/2024

A rotina FsRtlGetNextLargeMcbEntry recupera uma execução de mapeamento de um MCB (bloco de controle de mapa).

Sintaxe

BOOLEAN FsRtlGetNextLargeMcbEntry(
       PLARGE_MCB Mcb,
  [in] ULONG      RunIndex,
       PLONGLONG  Vbn,
       PLONGLONG  Lbn,
       PLONGLONG  SectorCount
);

Parâmetros

Mcb

Ponteiro para uma estrutura inicializada do MCB.

[in] RunIndex

Índice baseado em zero da execução de mapeamento solicitada.

Vbn

Ponteiro para uma variável que recebe o VBN (número de bloco virtual inicial) da execução de mapeamento ou zero se a execução não existir. Seu valor não tem sentido se FsRtlGetNextLargeMcbEntry retornar FALSE.

Lbn

Ponteiro para uma variável que recebe o LBN (número de bloco lógico inicial) da execução de mapeamento ou zero se a execução não existir. Seu valor não tem sentido se FsRtlGetNextLargeMcbEntry retornar FALSE.

SectorCount

Ponteiro para uma variável que recebe o número de setores na execução de mapeamento ou zero se a execução não existir. Seu valor não tem sentido se FsRtlGetNextLargeMcbEntry retornar FALSE.

Valor de retorno

FsRtlGetNextLargeMcbEntry retornará verdadeiro se a execução de mapeamento solicitada existir no MCB, FALSE caso contrário.

Observações

FsRtlGetNextLargeMcbEntry recupera o VBN inicial, o LBN inicial e a contagem do setor para uma execução de mapeamento em um MCB.

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

Os buracos são contados como execuções.

O snippet de código a seguir mostra como imprimir todas as execuções em um arquivo:

for (i = 0; FsRtlGetNextLargeMcbEntry(Mcb,i,&Vbn,&Lbn,&Count); i++) {

    // print out vbn, lbn, and count

}

Requisitos

Requisito	Valor
da Plataforma de Destino	Universal
cabeçalho	ntifs.h (inclua Ntifs.h)
biblioteca	NtosKrnl.lib
de DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

Consulte também

FsRtlAddLargeMcbEntry

FsRtlInitializeLargeMcb

FsRtlLookupLargeMcbEntry

FsRtlLookupLastLargeMcbEntry

FsRtlLookupLastLargeMcbEntryAndIndex

FsRtlNumberOfRunsInLargeMcb

FsRtlRemoveLargeMcbEntry

FsRtlSplitLargeMcb

FsRtlTruncateLargeMcb

FsRtlUninitializeLargeMcb

Partilhar via