Fonction FsRtlResetLargeMcb (ntifs.h)

Article
02/29/2024

La routine FsRtlResetLargeMcb tronque une structure de bloc de contrôle de carte (MCB) pour contenir aucune paire de mappage. Il ne réduit pas le tableau de paires de mappage.

Syntaxe

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

Paramètres

[in] Mcb

Pointeur vers la structure MCB à tronquer.

[in] SelfSynchronized

Indique si l’appelant est déjà synchronisé par rapport au MCB.

Valeur de retour

None

Remarques

FsRtlResetLargeMcb tronque une structure de bloc de contrôle de carte (MCB). Les systèmes de fichiers utilisent des structures MCB pour mapper des numéros de blocs virtuels (VBN) d’un fichier aux numéros de blocs logiques (LBN) correspondants sur le disque.

Note Les 32 bits supérieurs du LBN sont ignorés. Seuls les 32 bits inférieurs sont utilisés.

Les systèmes de fichiers doivent appeler FsRtlInitializeLargeMcb avant d’utiliser tout autre FsRtl... Mcb... routines sur la structure MCB.

Si l’appelant est déjà synchronisé (le paramètre SelfSynchronized est défini sur TRUE), de sorte qu’aucun autre thread d’opération ne peut appeler une routine Mcb sur ce MCB pendant cet appel, FsRtlResetLargeMcb efface simplement le nombre actuel de paires de mappage. Si le paramètre SelfSynchronized a la valeur FALSE, FsRtlResetLargeMcb sérialise l’accès au Mcb avant d’effacer le nombre de paires, ce qui nécessite plus de temps.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP
Plateforme cible	Universal
En-tête	ntifs.h (inclure Ntifs.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL