Função FsRtlRemoveLargeMcbEntry (ntifs.h)

Artigo
12/21/2024

A rotina de FsRtlRemoveLargeMcbEntry remove um ou mais mapeamentos de um MCB (bloco de controle de mapa).

Sintaxe

void FsRtlRemoveLargeMcbEntry(
  PLARGE_MCB Mcb,
  LONGLONG   Vbn,
  LONGLONG   SectorCount
);

Parâmetros

Mcb

Ponteiro para a estrutura do MCB.

Vbn

Iniciando o VBN (número de bloco virtual) do intervalo para o qual os mapeamentos devem ser removidos do MCB.

SectorCount

Número de setores (VBNs) no intervalo para o qual os mapeamentos devem ser removidos.

Valor de retorno

Nenhum

Observações

FsRtlRemoveLargeMcbEntry remove todos os mapeamentos de VBNs para LBNs no MCB que se enquadram no intervalo de VBNs que começa com *LargeVbn e termina com (*LargeVbn + LargeSectorCount - 1).

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

Os buracos (lacunas) entre mapeamentos são ignorados.

Se o intervalo de VBNs a serem removidos incluir o VBN mapeado mais alto no MCB, o membro PairCount do MCB será ajustado adequadamente.

Se ocorrer uma falha de alocação de pool, FsRtlRemoveLargeMcbEntry gerará uma exceção STATUS_INSUFFICIENT_RESOURCES. Para obter controle se essa falha de alocação de pool ocorrer, o driver deverá encapsular a chamada para FsRtlRemoveLargeMcbEntry em uma instrução try-except ou try-finally.

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

FsRtlGetNextLargeMcbEntry

FsRtlInitializeLargeMcb

FsRtlLookupLargeMcbEntry

FsRtlLookupLastLargeMcbEntry

FsRtlLookupLastLargeMcbEntryAndIndex

FsRtlNumberOfRunsInLargeMcb

FsRtlSplitLargeMcb

FsRtlTruncateLargeMcb

FsRtlUninitializeLargeMcb

Compartilhar via