FsRtlAddBaseMcbEntryEx, fonction (ntifs.h)

Article
12/20/2024

La fonction FsRtlAddBaseMcbEntryEx est utilisée pour ajouter un nouveau mappage des nombres de blocs virtuels (VBN) aux nombres de blocs logiques (LBN) à un bloc de contrôle de carte existant (MCB).

Syntaxe

NTSTATUS FsRtlAddBaseMcbEntryEx(
  PBASE_MCB Mcb,
  LONGLONG  Vbn,
  LONGLONG  Lbn,
  LONGLONG  SectorCount
);

Paramètres

Mcb

Fournit le Mcb dans lequel ajouter le nouveau mappage.

Vbn

Fournit le VBN de démarrage de la nouvelle exécution de mappage à ajouter à Mcb.

Lbn

Fournit le Lbn de départ de la nouvelle exécution de mappage à ajouter à mcb.

SectorCount

Fournit la taille de la nouvelle exécution de mappage (dans les secteurs).

Valeur de retour

Cette fonction retourne l’une des valeurs NTSTATUS suivantes :

Statut	Signification
STATUS_SUCCESSFUL	le mappage a été ajouté avec succès (c’est-à-dire que les nouveaux VBN ne sont pas entrés en collision avec les VBN existants),
STATUS_INSUFFICIENT_RESOURCES	Il n’y avait pas de mémoire pour ajouter le nouveau mappage.
STATUS_UNSUCCESSFULL	Il y a eu une collision avec les nouveaux VBN et les VBN existants.

Remarques

Le mappage des VBN ne doit pas déjà exister dans le Mcb. Si le mappage continue une exécution précédente, cette routine les fusionne en 1 exécution.

Si le pool n’est pas disponible pour stocker les informations que cette routine génère une valeur d’état indiquant des ressources insuffisantes.

Une valeur Lbn d’entrée de zéro est illégale (c’est-à-dire que la structure Mcb ne mappe jamais un VBN à une valeur zéro Lbn).

Exigences

Exigence	Valeur
d’en-tête	ntifs.h

Partager via