Partager via


FsRtlGetNextLargeMcbEntry, fonction (ntifs.h)

La routine FsRtlGetNextLargeMcbEntry récupère une exécution de mappage à partir d’un bloc de contrôle de carte (MCB).

Syntaxe

BOOLEAN FsRtlGetNextLargeMcbEntry(
       PLARGE_MCB Mcb,
  [in] ULONG      RunIndex,
       PLONGLONG  Vbn,
       PLONGLONG  Lbn,
       PLONGLONG  SectorCount
);

Paramètres

Mcb

Pointeur vers une structure MCB initialisée.

[in] RunIndex

Index de base zéro de l’exécution de mappage demandée.

Vbn

Pointeur vers une variable qui reçoit le numéro de bloc virtuel de départ (VBN) de l’exécution de mappage, ou zéro si l’exécution n’existe pas. Sa valeur n’a aucune signification si FsRtlGetNextLargeMcbEntry retourne FALSE.

Lbn

Pointeur vers une variable qui reçoit le numéro de bloc logique de départ (LBN) de l’exécution de mappage, ou zéro si l’exécution n’existe pas. Sa valeur n’a aucune signification si FsRtlGetNextLargeMcbEntry retourne FALSE.

SectorCount

Pointeur vers une variable qui reçoit le nombre de secteurs dans l’exécution du mappage, ou zéro si l’exécution n’existe pas. Sa valeur n’a aucune signification si FsRtlGetNextLargeMcbEntry retourne FALSE.

Valeur de retour

FsRtlGetNextLargeMcbEntry retourne TRUE si l’exécution de mappage demandée existe dans le MCB, FALSE sinon.

Remarques

FsRtlGetNextLargeMcbEntry récupère le vbN de démarrage, le nombre de LBN de démarrage et le nombre de secteurs pour une exécution de mappage dans un MCB.

Remarque Les 32 bits supérieurs du LBN sont ignorés. Seuls les 32 bits inférieurs sont utilisés.
 
Les trous sont comptés comme des exécutions.

L’extrait de code suivant montre comment imprimer toutes les exécutions dans un fichier :

for (i = 0; FsRtlGetNextLargeMcbEntry(Mcb,i,&Vbn,&Lbn,&Count); i++) {

    // print out vbn, lbn, and count

}

Exigences

Exigence Valeur
plateforme cible Universel
d’en-tête ntifs.h (include Ntifs.h)
bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

Voir aussi

FsRtlAddLargeMcbEntry

FsRtlInitializeLargeMcb

FsRtlLookupLargeMcbEntry

FsRtlLookupLastLargeMcbEntry

FsRtlLookupLastLargeMcbEntryAndIndex

FsRtlNumberOfRunsInLargeMcb

FsRtlRemoveLargeMcbEntry

FsRtlSplitLargeMcb

FsRtlTruncateLargeMcb

FsRtlUninitializeLargeMcb