FsRtlLookupLargeMcbEntry, fonction (ntifs.h)

Article
02/07/2025

Étant donné un numéro de bloc virtuel (VBN) et un bloc de contrôle de carte (MCB), le FsRtlLookupLargeMcbEntry routine recherche les informations de mappage mcB correspondant au VBN spécifié.

Syntaxe

BOOLEAN FsRtlLookupLargeMcbEntry(
                  PLARGE_MCB Mcb,
                  LONGLONG   Vbn,
                  PLONGLONG  Lbn,
                  PLONGLONG  SectorCountFromLbn,
                  PLONGLONG  StartingLbn,
                  PLONGLONG  SectorCountFromStartingLbn,
  [out, optional] PULONG     Index
);

Paramètres

Mcb

Pointeur vers une structure MCB initialisée.

Vbn

Pointeur vers le VBN demandé.

Lbn

Pointeur vers une variable qui reçoit le LBN mappé à LargeVbn dans l’entrée de mappage, ou -1 s’il n’existe aucun LBN de ce type. Ce paramètre est facultatif et peut être NULL.

SectorCountFromLbn

Pointeur vers une variable qui reçoit le nombre de secteurs qui suivent LargeVbn dans l’exécution du mappage. Ce paramètre est facultatif et peut être NULL.

StartingLbn

Pointeur vers une variable qui reçoit le LBN correspondant au début de l’exécution du mappage, ou -1 si aucun tel LBN n’existe. Ce paramètre est facultatif et peut être NULL.

SectorCountFromStartingLbn

Pointeur vers une variable qui reçoit le nombre de secteurs dans l’exécution du mappage. Ce paramètre est facultatif et peut être NULL.

[out, optional] Index

Pointeur vers une variable qui reçoit l’index de l’exécution de mappage qui contient le VBN. Ce paramètre est facultatif et peut être NULL.

Valeur de retour

FsRtlLookupLargeMcbEntry retourne TRUE si le VBN spécifié se trouve dans la plage de VBN mappés par mcB, FALSE sinon.

Remarques

FsRtlLookupLargeMcbEntry recherche une entrée de mappage dans le MCB dont l’exécution inclut le VBN spécifié.

Si un tel mappage existe, l’opération de recherche génère des valeurs positives pour le nombre de LBN et de secteur correspondants, et FsRtlLookupLargeMcbEntry retourne TRUE.
Si aucun tel mappage n’existe, mais que le VBN spécifié est inférieur au VBN le plus élevé mappé par le MCB, il s’agit d’un trou dans le mappage. Dans ce cas, FsRtlLookupLargeMcbEntry retourne toujours TRUE, mais l’opération de recherche génère une valeur de -1 pour le LBN.
Si le VBN spécifié est supérieur au VBN le plus élevé mappé par le MCB ou si le MCB ne contient aucun mappage, FsRtlLookupLargeMcbEntry retourne FALSE.

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