Fonction FsRtlLookupLargeMcbEntry (ntifs.h)

Article
02/29/2024

Avec un numéro de bloc virtuel (VBN) et un bloc de contrôle de carte (MCB), la routine FsRtlLookupLargeMcbEntry recherche dans le MCB des informations de mappage 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 si aucun LBN de ce type n’existe. 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 de 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 de mappage, ou -1 si aucun LBN de ce type 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 de 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 retournée

FsRtlLookupLargeMcbEntry retourne TRUE si le VBN spécifié se trouve dans la plage de VBN qui sont mappés par le MCB, false dans le cas contraire.

Remarques

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

S’il existe un tel mappage, l’opération de recherche génère des valeurs positives pour le LBN et le nombre de secteurs correspondants, et FsRtlLookupLargeMcbEntry retourne TRUE.
S’il n’existe aucun mappage de ce type, 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 numéro DEM 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.