Freigeben über


NTFS_VOLUME_DATA_BUFFER-Struktur (winioctl.h)

Stellt Volumedaten dar. Diese Struktur wird an den FSCTL_GET_NTFS_VOLUME_DATA-Steuerelementcode übergeben.

Syntax

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;

Member

VolumeSerialNumber

Die Seriennummer des Volumes. Dies ist eine eindeutige Nummer, die dem Volumemedium vom Betriebssystem zugewiesen ist.

NumberSectors

Die Anzahl der Sektoren im angegebenen Volumen.

TotalClusters

Die Anzahl der verwendeten und freien Cluster im angegebenen Volume.

FreeClusters

Die Anzahl der freien Cluster im angegebenen Volume.

TotalReserved

Die Anzahl der reservierten Cluster im angegebenen Volume.

BytesPerSector

Die Anzahl der Bytes in einem Sektor auf dem angegebenen Volume.

BytesPerCluster

Die Anzahl der Bytes in einem Cluster auf dem angegebenen Volume. Dieser Wert wird auch als Clusterfaktor bezeichnet.

BytesPerFileRecordSegment

Die Anzahl der Bytes in einem Dateidatensatzsegment.

ClustersPerFileRecordSegment

Die Anzahl der Cluster in einem Dateidatensatzsegment.

MftValidDataLength

Die Länge der Masterdateitabelle in Bytes.

MftStartLcn

Die Anfangsnummer des logischen Clusters der Masterdateitabelle.

Mft2StartLcn

Die Startnummer des logischen Clusters der Masterdateitabellenspiegelung.

MftZoneStart

Die starte logische Clusternummer der Masterdateitabellenzone.

MftZoneEnd

Die endende logische Clusternummer der Masterdateitabellenzone.

Hinweise

Reservierte Cluster sind die kostenlosen Cluster, die für die spätere Verwendung durch Windows reserviert sind.

Die NTFS_VOLUME_DATA_BUFFER-Struktur stellt die grundlegenden Informationen dar, die von FSCTL_GET_NTFS_VOLUME_DATA zurückgegeben werden. Um Informationen zu erweiterten Volumes zu erfahren, übergeben Sie einen Puffer, der die kombinierte Größe der NTFS_VOLUME_DATA_BUFFER - und NTFS_EXTENDED_VOLUME_DATA-Strukturen aufweist. Bei Erfolgreicher Ausführung enthält der von FSCTL_GET_NTFS_VOLUME_DATA zurückgegebene Puffer die Informationen, die beiden Strukturen zugeordnet sind. Die NTFS_VOLUME_DATA_BUFFER-Struktur wird immer ab dem Anfang des Puffers gefüllt, wobei die NTFS_EXTENDED_VOLUME_DATA-Struktur unmittelbar folgt. Die NTFS_EXTENDED_VOLUME_DATA-Struktur ist wie folgt definiert:

C++
typedef struct {
    ULONG ByteCount;
    USHORT MajorVersion;
    USHORT MinorVersion;
} NTFS_EXTENDED_VOLUME_DATA, *PNTFS_EXTENDED_VOLUME_DATA;
Diese Struktur enthält die Haupt- und Nebenversionsinformationen für ein NTFS-Volume. Das ByteCount-Element gibt die Gesamtbytes des Ausgabepuffers zurück, der durch den Aufruf von FSCTL_GET_NTFS_VOLUME_DATA für diese Struktur verwendet wird. Dieser Wert sollte lauten sizeof(NTFS_EXTENDED_VOLUME_DATA) , wenn der übergebene Puffer groß genug war, um ihn zu halten, andernfalls ist der Wert kleiner als sizeof(NTFS_EXTENDED_VOLUME_DATA).

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Kopfzeile winioctl.h (einschließlich Windows.h)

Weitere Informationen

FSCTL_GET_NTFS_VOLUME_DATA