estructura NTFS_VOLUME_DATA_BUFFER (winioctl.h)

  • Artículo

Representa los datos del volumen. Esta estructura se pasa al código de control FSCTL_GET_NTFS_VOLUME_DATA .

Sintaxis

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

Número de serie del volumen. Se trata de un número único asignado al medio de volumen por el sistema operativo.

NumberSectors

Número de sectores del volumen especificado.

TotalClusters

Número de clústeres usados y libres en el volumen especificado.

FreeClusters

Número de clústeres libres en el volumen especificado.

TotalReserved

Número de clústeres reservados en el volumen especificado.

BytesPerSector

Número de bytes de un sector en el volumen especificado.

BytesPerCluster

Número de bytes de un clúster en el volumen especificado. Este valor también se conoce como factor de clúster.

BytesPerFileRecordSegment

Número de bytes en un segmento de registro de archivo.

ClustersPerFileRecordSegment

El número de clústeres de un segmento de registro de archivos.

MftValidDataLength

Longitud de la tabla de archivos maestros, en bytes.

MftStartLcn

Número de clúster lógico inicial de la tabla de archivos maestros.

Mft2StartLcn

Número de clúster lógico inicial del reflejo de la tabla de archivos maestros.

MftZoneStart

Número de clúster lógico inicial de la zona de tabla de archivos maestros.

MftZoneEnd

Número de clúster lógico final de la zona de tabla de archivos maestros.

Observaciones

Los clústeres reservados son los clústeres gratuitos reservados para su uso posterior por Windows.

La estructura NTFS_VOLUME_DATA_BUFFER representa la información básica devuelta por FSCTL_GET_NTFS_VOLUME_DATA. Para obtener información de volumen extendida, pase un búfer que sea el tamaño combinado de las estructuras de NTFS_VOLUME_DATA_BUFFER y NTFS_EXTENDED_VOLUME_DATA . Tras la operación correcta, el búfer devuelto por FSCTL_GET_NTFS_VOLUME_DATA contendrá la información asociada a ambas estructuras. La estructura NTFS_VOLUME_DATA_BUFFER siempre se rellenará a partir del principio del búfer, con la estructura NTFS_EXTENDED_VOLUME_DATA inmediatamente después. La estructura NTFS_EXTENDED_VOLUME_DATA se define de la siguiente manera:

C++ 
typedef struct {
    ULONG ByteCount;
    USHORT MajorVersion;
    USHORT MinorVersion;
} NTFS_EXTENDED_VOLUME_DATA, *PNTFS_EXTENDED_VOLUME_DATA;
Esta estructura contiene la información de la versión principal y secundaria de un volumen NTFS. El miembro ByteCount devolverá el total de bytes del búfer de salida utilizado para esta estructura por la llamada a FSCTL_GET_NTFS_VOLUME_DATA. Este valor debe ser sizeof(NTFS_EXTENDED_VOLUME_DATA) si el búfer pasado era lo suficientemente grande como para contenerlo; de lo contrario, el valor será menor que sizeof(NTFS_EXTENDED_VOLUME_DATA).

Requisitos

   
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado winioctl.h (incluye Windows.h)

Consulte también

FSCTL_GET_NTFS_VOLUME_DATA