FsRtlRemoveLargeMcbEntry, fonction (ntifs.h)

Article
12/20/2024

La routine FsRtlRemoveLargeMcbEntry supprime un ou plusieurs mappages d’un bloc de contrôle de carte (MCB).

Syntaxe

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

Paramètres

Mcb

Pointeur vers la structure MCB.

Vbn

Démarrage du numéro de bloc virtuel (VBN) de la plage pour laquelle les mappages doivent être supprimés du MCB.

SectorCount

Nombre de secteurs (VBN) dans la plage pour laquelle les mappages doivent être supprimés.

Valeur de retour

Aucun

Remarques

FsRtlRemoveLargeMcbEntry supprime tous les mappages de VBN aux réseaux LB dans la plage de vbn commençant par *LargeVbn et se termine par (*LargeVbn + LargeSectorCount - 1).

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

Les trous (écarts) entre les mappages sont ignorés.

Si la plage de VBN à supprimer inclut le VBN mappé le plus élevé dans le MCB, le membre PairCount de MCB est ajusté en conséquence.

Si un échec d’allocation de pool se produit, FsRtlRemoveLargeMcbEntry déclenche une exception STATUS_INSUFFICIENT_RESOURCES. Pour contrôler si cet échec d’allocation de pool se produit, le pilote doit encapsuler l’appel à FsRtlRemoveLargeMcbEntry dans une instruction try-except try-except ou try-finally.