Fonction FsRtlAddBaseMcbEntryEx (ntifs.h)

  • Article

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

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épart de la nouvelle exécution de mappage à ajouter au Mcb.

Lbn

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

SectorCount

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

Valeur retournée

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 n’ont pas été 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 poursuit une exécution précédente, cette routine les fusionnera en 1 exécution.

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

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

Configuration requise

Condition requise Valeur
En-tête ntifs.h