VDS_STORAGE_POOL_PROP 結構 (vdshwprv.h)

發行項
03/08/2023

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

語法

typedef struct _VDS_STORAGE_POOL_PROP {
  VDS_OBJECT_ID           id;
  VDS_STORAGE_POOL_STATUS status;
  VDS_HEALTH              health;
  VDS_STORAGE_POOL_TYPE   type;
  LPWSTR                  pwszName;
  LPWSTR                  pwszDescription;
  ULONGLONG               ullTotalConsumedSpace;
  ULONGLONG               ullTotalManagedSpace;
  ULONGLONG               ullRemainingFreeSpace;
} VDS_STORAGE_POOL_PROP, *PVDS_STORAGE_POOL_PROP;

成員

id

識別存放集區物件的 VDS_OBJECT_ID 值。

status

指定存放集區狀態的VDS_STORAGE_POOL_STATUS 列舉值。

health

指定存放集區健全狀況的VDS_HEALTH 列舉值。以下是這個成員的有效值。

不支援 Windows Server 2008、Windows Vista 和 Windows Server 2003： VDS_H_DEGRADED 。

VDS_H_UNKNOWN (0)

VDS_H_HEALTHY (1)

VDS_H_DEGRADED (11)

type

指定存放集區類型的 VDS_STORAGE_POOL_TYPE 列舉值。

pwszName

指定存放集區名稱的字串。

pwszDescription

包含存放集區描述的字串。

ullTotalConsumedSpace

備份存放集區的實體儲存體數量，以位元組為單位。這個成員的值必須小於或等於VDS_POOL_ATTRIBUTES結構的ullProvisionedSpace成員的值。

ullTotalManagedSpace

此存放集區中可以配置的空間，以位元組為單位，以建立 (LUN 或集區) 的子儲存體元素，包括已配置的空間。視儲存集區設定的方式而定，此成員的值可能小於 ullTotalConsumedSpace 成員的值。例如，如果儲存集區設定為鏡像集區， 則 ullTotalManagedSpace 的值只與 ullTotalConsumedSpace 成員的值相同。

ullRemainingFreeSpace

可用來從這個集區建立新 LUN 或子存放集區的大小上限，或擴充現有的 LUN 或子存放集區。若要計算已配置給現有 LUN 或子存放集區的受控空間數量，請從 ullTotalManagedSpace 成員的值減去此成員的值。

備註

IVdsStoragePool：：GetProperties會傳回這個結構來報告存放集區物件的屬性。

下列範例示範 ullTotalConsumedSpace、 ullTotalManagedSpace和 ullRemainingFreeSpace 成員如何一起運作。

範例 1

假設您有 2 個磁片磁碟機，每個磁片磁碟機 1 TB。假設您執行下列動作：

建立存放集區作為鏡像集區。
建立大小為 200 GB 的 LUN。

ullTotalConsumedSpace = 2 TB。這是實體儲存體或實體磁片支援的儲存集區空間數量。從集區建立 LUN 並不會變更此號碼。

ullTotalManagedSpace = 1 TB。這是可從此集區建立的 LUN 或存放集區大小上限。只有 1 TB 可用，因為集區類型是只有 2 個 plexes 的鏡像。

注意如果集區類型為 RAID5，ullTotalManagedSpace會 (N-1) /NullTotalConsumedSpace，其中N * 是資料行數目。例如，使用 5 個磁片磁碟機和 5 個數據行， ullTotalManagedSpace 會 (5-1) /5 * ullTotalConsumedSpace 或 1.6 TB。

ullRemainingFreeSpace = 800 GB (1 TB – 200 GB) ，因為 200GB 已配置給 LUN。

(ullTotalManagedSpaceullRemainingFreeSpace - ) 是配置給從此集區建立之 LUN 和集區的受控空間數量。在此範例中，ullTotalManagedSpaceullRemainingFreeSpace - = 200 GB。

範例 2

假設您有 2 個磁片磁碟機，每個磁片磁碟機 1 TB。假設您執行下列動作：

建立存放集區作為鏡像集區。
建立大小為 10 TB 的精簡布建 LUN。

ullProvisionedSpace = 10 TB。這僅適用于精簡布建的集區。這是為集區布建的總空間。集區耗用的總空間小於或等於為集區布建的總空間。

ullTotalConsumedSpace = 2 TB。

ullTotalManagedSpace = 1 TB。

ullRemainingFreeSpace = 1 TB 減去目前備份 LUN 的受控空間數量。

注意雖然 LUN 的大小為 10 TB，但支援 LUN 的受控空間可能最小為 10 GB，在此情況下，有 20 GB 的耗用空間支援鏡像 LUN。

規格需求


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

另請參閱

IVdsStoragePool：：GetProperties

共用方式為