Função FsRtlResetLargeMcb (ntifs.h)

Artigo
02/29/2024

A rotina FsRtlResetLargeMcb trunca uma estrutura mcb (bloco de controle de mapa) para conter zero pares de mapeamento. Ele não reduz a matriz de pares de mapeamento.

Sintaxe

void FsRtlResetLargeMcb(
  [in] PLARGE_MCB Mcb,
  [in] BOOLEAN    SelfSynchronized
);

Parâmetros

[in] Mcb

Ponteiro para a estrutura MCB a ser truncada.

[in] SelfSynchronized

Indica se o chamador já está sincronizado em relação ao MCB.

Retornar valor

Nenhum

Comentários

FsRtlResetLargeMcb trunca uma estrutura mcb (bloco de controle de mapa). Os sistemas de arquivos usam estruturas MCB para mapear números de bloco virtual (VBN) para um arquivo para os LBN (números de bloco lógico) correspondentes no disco.

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

Os sistemas de arquivos devem chamar FsRtlInitializeLargeMcb antes de usar qualquer outro FsRtl... Mcb... rotinas na estrutura MCB.

Se o chamador já estiver sincronizado (o parâmetro SelfSynchronized estiver definido como TRUE), de modo que nenhum outro thread de operação possa chamar uma rotina Mcb nesse MCB durante essa chamada, fsRtlResetLargeMcb apenas limpará a contagem de pares de mapeamento atual. Se o parâmetro SelfSynchronized for definido como FALSE, FsRtlResetLargeMcb serializará o acesso ao Mcb antes de limpar a contagem de pares, o que requer mais tempo.

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