VDS_VOLUME_PROP2結構 (vds.h)

發行項
03/13/2024

[從 Windows 8 和 Windows Server 2012 開始，Windows 記憶體管理 API 會取代虛擬磁碟服務 COM 介面。]

定義磁碟區對象的屬性。這個結構與 VDS_VOLUME_PROP 結構相同，不同之處在於它也會包含磁碟區 GUID。

語法

typedef struct _VDS_VOLUME_PROP2 {
  VDS_OBJECT_ID        id;
  VDS_VOLUME_TYPE      type;
  VDS_VOLUME_STATUS    status;
  VDS_HEALTH           health;
  VDS_TRANSITION_STATE TransitionState;
  ULONGLONG            ullSize;
  ULONG                ulFlags;
  VDS_FILE_SYSTEM_TYPE RecommendedFileSystemType;
  ULONG                cbUniqueId;
  LPWSTR               pwszName;
  BYTE                 *pUniqueId;
} VDS_VOLUME_PROP2, *PVDS_VOLUME_PROP2;

成員

id

磁碟區的 GUID。

type

指定磁碟區類型的 VDS_VOLUME_TYPE 列舉值。磁碟區類型簡單、跨越、等量 (RAID-0) 、鏡像或等量等量， (RAID-5) 。

status

指定磁碟區狀態的VDS_VOLUME_STATUS 列舉值。

health

指定磁碟區健全狀況狀態的VDS_HEALTH 列舉值。

TransitionState

指定磁碟區轉換狀態的VDS_TRANSITION_STATE 列舉值。

ullSize

磁碟區的大小，以位元組為單位。

ulFlags

描述磁碟區的 VDS_VOLUME_FLAG 列舉值的位掩碼。

RecommendedFileSystemType

指定磁碟區慣用檔案系統的 VDS_FILE_SYSTEM_TYPE 列舉值。必須是下列其中一項：VDS_FST_NTFS、VDS_FST_FAT、VDS_FST_FAT32、VDS_FST_UDF、VDS_FST_CDFS或VDS_FST_UNKNOWN。

cbUniqueId

pUniqueId 成員指向的位元組陣組長度。

pwszName

用來使用 CreateFile 函式開啟磁碟區句柄的名稱。例如，\？\GLOBALROOT\Device\HarddiskVolume1。

pUniqueId

位元組陣列，其中包含磁碟區的唯一標識符。

備註

IVdsVolume2：：GetProperties2 方法會傳回這個結構來報告磁碟區對象的屬性。

當磁碟區脫機時，VDS_VF_PERMANENTLY_DISMOUNTED旗標會在VDS_VOLUME_PROP2結構的 ulFlags 成員中設定，而VDS_VS_OFFLINE磁碟區狀態值也會在此結構的狀態成員中設定。

針對 GPT 和動態磁碟區， pUniqueId 成員指向的唯一標識碼是全域唯一的。

對於抽取式媒體磁碟驅動器，磁碟區存在，而且即使裝置中沒有媒體，也有自己的唯一標識符。如果磁碟區在卸除式媒體上格式化，該磁碟區有自己的唯一標識符。如需詳細資訊，請參閱支援記憶體類別驅動程式中的掛接管理員要求。

唯一標識碼的格式可能會因不同類型的裝置和磁碟區而有所不同。對於 MBR 磁碟上的基本磁碟區，唯一標識符是以磁碟簽章和磁碟分區位移為基礎。因為磁碟簽章和磁碟分區位移是 DWORD 值，所以無法保證唯一標識碼在所有計算機上都是全域唯一的。

如果磁碟簽章變更，磁碟區的唯一標識符也會變更。磁碟簽章變更通常是因為磁碟複製期間發生衝突。

請注意，唯一標識符與磁碟區 GUID 路徑不同。若要尋找磁碟區的磁碟區 GUID 路徑，請使用 IVdsVolumeMF3：：QueryVolumeGuidPathnames 方法。

規格需求

需求	值
最低支援的用戶端	Windows 7 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 R2 [僅限桌面應用程式]
標頭	vds.h