structure RETRIEVAL_POINTERS_BUFFER (winioctl.h)

  • Article

Contient la sortie du code de contrôle FSCTL_GET_RETRIEVAL_POINTERS.

Syntaxe

typedef struct RETRIEVAL_POINTERS_BUFFER {
  DWORD                    ExtentCount;
  LARGE_INTEGER            StartingVcn;
  struct {
    LARGE_INTEGER NextVcn;
    LARGE_INTEGER Lcn;
  };
  __unnamed_struct_1932_64 Extents[1];
} RETRIEVAL_POINTERS_BUFFER, *PRETRIEVAL_POINTERS_BUFFER;

Membres

ExtentCount

Nombre d’éléments dans le tableau Étendues .

StartingVcn

VCN de démarrage retourné par l’appel de fonction. Il ne s’agit pas nécessairement du VCN demandé par l’appel de fonction, car le pilote de système de fichiers peut arrondir au premier VCN de l’étendue dans laquelle le VCN de démarrage demandé est trouvé.

NextVcn

Lcn

Extents[1]

Tableau de structures d’étendues . Pour connaître le nombre de membres dans le tableau, consultez ExtentCount. Chaque membre du tableau a les membres suivants.

NextVcn

VCN à laquelle commence l’étendue suivante. Cette valeur moins StartingVcn (pour le premier membre du tableau Extents ) ou NextVcn du membre précédent du tableau (pour tous les autres membres du tableau Extents ) correspond à la longueur, dans les clusters, de l’étendue actuelle. La longueur est une entrée de l’opération FSCTL_MOVE_FILE .

Lcn

LCN à laquelle l’étendue actuelle commence sur le volume. Cette valeur est une entrée dans l’opération FSCTL_MOVE_FILE . Sur le système de fichiers NTFS, la valeur (LONGLONG) -1 indique soit une unité de compression partiellement allouée, soit une région non allouée d’un fichier partiellement alloué.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
En-tête winioctl.h (inclure Windows.h)

Voir aussi

Défragmentation

FSCTL_GET_RETRIEVAL_POINTERS

FSCTL_MOVE_FILE