NTFS_VOLUME_DATA_BUFFER structure (winioctl.h)

Article
03/08/2023

Représente des données de volume. Cette structure est passée au code de contrôle FSCTL_GET_NTFS_VOLUME_DATA .

Syntaxe

typedef struct {
  LARGE_INTEGER VolumeSerialNumber;
  LARGE_INTEGER NumberSectors;
  LARGE_INTEGER TotalClusters;
  LARGE_INTEGER FreeClusters;
  LARGE_INTEGER TotalReserved;
  DWORD         BytesPerSector;
  DWORD         BytesPerCluster;
  DWORD         BytesPerFileRecordSegment;
  DWORD         ClustersPerFileRecordSegment;
  LARGE_INTEGER MftValidDataLength;
  LARGE_INTEGER MftStartLcn;
  LARGE_INTEGER Mft2StartLcn;
  LARGE_INTEGER MftZoneStart;
  LARGE_INTEGER MftZoneEnd;
} NTFS_VOLUME_DATA_BUFFER, *PNTFS_VOLUME_DATA_BUFFER;

Membres

VolumeSerialNumber

Numéro de série du volume. Il s’agit d’un numéro unique attribué au support de volume par le système d’exploitation.

NumberSectors

Nombre de secteurs dans le volume spécifié.

TotalClusters

Nombre de clusters utilisés et gratuits dans le volume spécifié.

FreeClusters

Nombre de clusters libres dans le volume spécifié.

TotalReserved

Nombre de clusters réservés dans le volume spécifié.

BytesPerSector

Nombre d’octets dans un secteur sur le volume spécifié.

BytesPerCluster

Nombre d’octets dans un cluster sur le volume spécifié. Cette valeur est également appelée facteur de cluster.

BytesPerFileRecordSegment

Nombre d’octets dans un segment d’enregistrement de fichier.

ClustersPerFileRecordSegment

Nombre de clusters dans un segment d’enregistrement de fichier.

MftValidDataLength

Longueur de la table de fichiers maîtres, en octets.

MftStartLcn

Numéro de cluster logique de départ de la table de fichiers maîtres.

Mft2StartLcn

Numéro de cluster logique de départ du miroir de table de fichiers maîtres.

MftZoneStart

Numéro de cluster logique de départ de la zone de table de fichiers maîtres.

MftZoneEnd

Numéro de cluster logique de fin de la zone de table de fichiers maîtres.

Remarques

Les clusters réservés sont les clusters gratuits réservés pour une utilisation ultérieure par Windows.

La structure NTFS_VOLUME_DATA_BUFFER représente les informations de base retournées par FSCTL_GET_NTFS_VOLUME_DATA. Pour les informations de volume étendues, transmettez une mémoire tampon qui correspond à la taille combinée des structures NTFS_VOLUME_DATA_BUFFER et NTFS_EXTENDED_VOLUME_DATA . En cas de réussite, la mémoire tampon retournée par FSCTL_GET_NTFS_VOLUME_DATA contiendra les informations associées aux deux structures. La structure NTFS_VOLUME_DATA_BUFFER est toujours remplie à partir du début de la mémoire tampon, avec la structure NTFS_EXTENDED_VOLUME_DATA immédiatement suivante. La structure NTFS_EXTENDED_VOLUME_DATA est définie comme suit :

C++
typedef struct { ULONG ByteCount; USHORT MajorVersion; USHORT MinorVersion; } NTFS_EXTENDED_VOLUME_DATA, *PNTFS_EXTENDED_VOLUME_DATA;

Cette structure contient les informations de version principale et secondaire d’un volume NTFS. Le membre ByteCount retourne le total des octets de la mémoire tampon de sortie utilisée pour cette structure par l’appel à FSCTL_GET_NTFS_VOLUME_DATA. Cette valeur doit être sizeof(NTFS_EXTENDED_VOLUME_DATA) si la mémoire tampon passée était suffisamment grande pour la contenir, sinon la valeur sera inférieure sizeof(NTFS_EXTENDED_VOLUME_DATA)à .

Configuration requise


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

FSCTL_GET_NTFS_VOLUME_DATA

Partager via