NTFS_VOLUME_DATA_BUFFER struttura (winioctl.h)

Articolo
03/08/2023

Rappresenta i dati del volume. Questa struttura viene passata al codice di controllo FSCTL_GET_NTFS_VOLUME_DATA .

Sintassi

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;

Members

VolumeSerialNumber

Numero di serie del volume. Si tratta di un numero univoco assegnato al supporto del volume dal sistema operativo.

NumberSectors

Numero di settori nel volume specificato.

TotalClusters

Numero di cluster usati e gratuiti nel volume specificato.

FreeClusters

Numero di cluster gratuiti nel volume specificato.

TotalReserved

Numero di cluster riservati nel volume specificato.

BytesPerSector

Numero di byte in un settore nel volume specificato.

BytesPerCluster

Numero di byte in un cluster nel volume specificato. Questo valore è noto anche come fattore del cluster.

BytesPerFileRecordSegment

Numero di byte in un segmento di record di file.

ClustersPerFileRecordSegment

Numero di cluster in un segmento di record di file.

MftValidDataLength

Lunghezza della tabella file master, in byte.

MftStartLcn

Numero di cluster logico iniziale della tabella file master.

Mft2StartLcn

Numero di cluster logico iniziale del mirror della tabella file master.

MftZoneStart

Numero di cluster logico iniziale della zona della tabella file master.

MftZoneEnd

Numero di cluster logico finale della zona della tabella file master.

Commenti

I cluster riservati sono i cluster gratuiti riservati per un uso successivo da parte di Windows.

La struttura NTFS_VOLUME_DATA_BUFFER rappresenta le informazioni di base restituite da FSCTL_GET_NTFS_VOLUME_DATA. Per informazioni sul volume estese, passare un buffer che corrisponde alla dimensione combinata delle strutture NTFS_VOLUME_DATA_BUFFER e NTFS_EXTENDED_VOLUME_DATA . Al termine dell'operazione, il buffer restituito da FSCTL_GET_NTFS_VOLUME_DATA conterrà le informazioni associate a entrambe le strutture. La struttura NTFS_VOLUME_DATA_BUFFER verrà sempre riempita a partire dall'inizio del buffer, con la struttura NTFS_EXTENDED_VOLUME_DATA immediatamente successiva. La struttura NTFS_EXTENDED_VOLUME_DATA è definita come segue:

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

Questa struttura contiene le informazioni sulla versione principale e secondaria per un volume NTFS. Il membro ByteCount restituirà i byte totali del buffer di output utilizzato per questa struttura dalla chiamata a FSCTL_GET_NTFS_VOLUME_DATA. Questo valore deve essere sizeof(NTFS_EXTENDED_VOLUME_DATA) se il buffer passato è abbastanza grande per tenerlo, in caso contrario il valore sarà minore di sizeof(NTFS_EXTENDED_VOLUME_DATA).

Requisiti


Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	winioctl.h (include Windows.h)

Vedi anche

FSCTL_GET_NTFS_VOLUME_DATA

Share via