共用方式為


VDS_STORAGE_POOL_PROP 結構 (vdshwprv.h)

[從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會傳回這個結構來報告存放集區物件的屬性。

下列範例示範 ullTotalConsumedSpaceullTotalManagedSpaceullRemainingFreeSpace 成員如何一起運作。

範例 1

假設您有 2 個磁片磁碟機,每個磁片磁碟機 1 TB。 假設您執行下列動作:
  1. 建立存放集區作為鏡像集區。
  2. 建立大小為 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。 假設您執行下列動作:
  1. 建立存放集區作為鏡像集區。
  2. 建立大小為 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