共用方式為

NTFS_VOLUME_DATA_BUFFER結構 (winioctl.h)

  • 發行項

表示磁片區資料。 此結構會傳遞至 FSCTL_GET_NTFS_VOLUME_DATA 控制項程式碼。

語法

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;

成員

VolumeSerialNumber

磁片區的序號。 這是作業系統指派給磁片區媒體的唯一號碼。

NumberSectors

指定磁片區中的磁區數目。

TotalClusters

指定磁片區中已使用和可用叢集的數目。

FreeClusters

指定磁片區中的可用叢集數目。

TotalReserved

指定磁片區中的保留叢集數目。

BytesPerSector

指定磁片區上磁區中的位元組數目。

BytesPerCluster

指定磁片區上叢集中的位元組數目。 這個值也稱為叢集因數。

BytesPerFileRecordSegment

檔案記錄區段中的位元組數目。

ClustersPerFileRecordSegment

檔案記錄區段中的叢集數目。

MftValidDataLength

主要檔案資料表的長度，以位元組為單位。

MftStartLcn

主檔案資料表的起始邏輯叢集編號。

Mft2StartLcn

主檔案資料表鏡像的起始邏輯叢集編號。

MftZoneStart

主要檔案資料表區域的起始邏輯叢集編號。

MftZoneEnd

主要檔案資料表區域的結束邏輯叢集編號。

備註

保留的叢集是保留供 Windows 稍後使用的免費叢集。

NTFS_VOLUME_DATA_BUFFER結構代表FSCTL_GET_NTFS_VOLUME_DATA傳回的基本資訊。 如需擴充的磁片區資訊，請傳遞緩衝區，該緩衝區是 NTFS_VOLUME_DATA_BUFFER 和 NTFS_EXTENDED_VOLUME_DATA 結構的組合大小。 成功時， FSCTL_GET_NTFS_VOLUME_DATA 傳回的緩衝區將包含與這兩個結構相關聯的資訊。 NTFS_VOLUME_DATA_BUFFER結構一律會從緩衝區開頭開始填入，並緊接NTFS_EXTENDED_VOLUME_DATA結構。 NTFS_EXTENDED_VOLUME_DATA結構的定義如下：

C++ 
typedef struct {
    ULONG ByteCount;
    USHORT MajorVersion;
    USHORT MinorVersion;
} NTFS_EXTENDED_VOLUME_DATA, *PNTFS_EXTENDED_VOLUME_DATA;
此結構包含 NTFS 磁片區的主要和次要版本資訊。 ByteCount成員會透過呼叫FSCTL_GET_NTFS_VOLUME_DATA，傳回用於此結構的輸出緩衝區總位元組數。 如果傳遞的緩衝區夠大而足以保存此值，則此值應該 sizeof(NTFS_EXTENDED_VOLUME_DATA) 小於 ，否則該值會小於 sizeof(NTFS_EXTENDED_VOLUME_DATA) 。

規格需求

   
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
標頭 winioctl.h (包含 Windows.h)

另請參閱

FSCTL_GET_NTFS_VOLUME_DATA