VDS_VOLUME_PROP2結構 (vds.h)
[從 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 |