Funzione FsRtlResetLargeMcb (ntifs.h)

Articolo
03/05/2024

La routine FsRtlResetLargeMcb tronca una struttura MCB (Map Control Block) per contenere coppie di mapping zero. Non compatta la matrice di coppie di mapping.

Sintassi

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

Parametri

[in] Mcb

Puntatore alla struttura MCB da troncare.

[in] SelfSynchronized

Indica se il chiamante è già sincronizzato rispetto al McB.

Valore restituito

nessuno

Osservazioni

FsRtlResetLargeMcb tronca una struttura MCB (Map Control Block). I file system usano strutture MCB per eseguire il mapping dei numeri di blocco virtuale (VBN) per un file ai numeri di blocco logici corrispondenti (LBN) su disco.

Nota I 32 bit superiori del codice LBN vengono ignorati. Vengono usati solo i 32 bit inferiori.

I file system devono chiamare FsRtlInitializeLargeMcb prima di usare qualsiasi altro fsRtl... Mcb... routine sulla struttura MCB.

Se il chiamante è già sincronizzato (il parametro SelfSynchronized è impostato su TRUE), in modo che nessun altro thread di operazione possa chiamare una routine Mcb su questo MCB durante questa chiamata, FsRtlResetLargeMcb cancella semplicemente il conteggio delle coppie di mapping correnti. Se il parametro SelfSynchronized è impostato su FALSE, FsRtlResetLargeMcb serializzerà l'accesso a Mcb prima di cancellare il conteggio delle coppie che richiede più tempo.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP
Piattaforma di destinazione	Universale
Intestazione	ntifs.h (include Ntifs.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL