VDS_POOL_ATTRIBUTES 結構 (vds.h)

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

定義 存放集區的屬性。

語法

typedef struct _VDS_POOL_ATTRIBUTES {
  ULONGLONG                  ullAttributeMask;
  VDS_RAID_TYPE              raidType;
  VDS_STORAGE_BUS_TYPE       busType;
  LPWSTR                     pwszIntendedUsage;
  BOOL                       bSpinDown;
  BOOL                       bIsThinProvisioned;
  ULONGLONG                  ullProvisionedSpace;
  BOOL                       bNoSinglePointOfFailure;
  ULONG                      ulDataRedundancyMax;
  ULONG                      ulDataRedundancyMin;
  ULONG                      ulDataRedundancyDefault;
  ULONG                      ulPackageRedundancyMax;
  ULONG                      ulPackageRedundancyMin;
  ULONG                      ulPackageRedundancyDefault;
  ULONG                      ulStripeSize;
  ULONG                      ulStripeSizeMax;
  ULONG                      ulStripeSizeMin;
  ULONG                      ulDefaultStripeSize;
  ULONG                      ulNumberOfColumns;
  ULONG                      ulNumberOfColumnsMax;
  ULONG                      ulNumberOfColumnsMin;
  ULONG                      ulDefaultNumberofColumns;
  ULONG                      ulDataAvailabilityHint;
  ULONG                      ulAccessRandomnessHint;
  ULONG                      ulAccessDirectionHint;
  ULONG                      ulAccessSizeHint;
  ULONG                      ulAccessLatencyHint;
  ULONG                      ulAccessBandwidthWeightHint;
  ULONG                      ulStorageCostHint;
  ULONG                      ulStorageEfficiencyHint;
  ULONG                      ulNumOfCustomAttributes;
  VDS_POOL_CUSTOM_ATTRIBUTES *pPoolCustomAttributes;
  BOOL                       bReserved1;
  BOOL                       bReserved2;
  ULONG                      ulReserved1;
  ULONG                      ulReserved2;
  ULONGLONG                  ullReserved1;
  ULONGLONG                  ullReserved2;
} VDS_POOL_ATTRIBUTES, *PVDS_POOL_ATTRIBUTES;

成員

ullAttributeMask

遮罩,指定這個存放集區所定義之 結構中的屬性。

有效的屬性旗標清單如下所示。 每個旗標都會對應至 VDS_POOL_ATTRIBUTES 結構中的成員。 未使用的位是保留的。

存放集區所定義的屬性
VDS_POOL_ATTRIB_RAIDTYPE
0x1L
raidType
VDS_POOL_ATTRIB_BUSTYPE
0x2L
busType
VDS_POOL_ATTRIB_ALLOW_SPINDOWN
0x4L
bSpinDown
VDS_POOL_ATTRIB_THIN_PROVISION
0x8L
bIsThinProvisioned
VDS_POOL_ATTRIB_NO_SINGLE_POF
0x10L
bNoSinglePointOfFailure
VDS_POOL_ATTRIB_DATA_RDNCY_MAX
0x20L
ulDataRedundancyMax
VDS_POOL_ATTRIB_DATA_RDNCY_MIN
0x40L
ulDataRedundancyMin
VDS_POOL_ATTRIB_DATA_RDNCY_DEF
0x80L
ulDataRedundancyDefault
VDS_POOL_ATTRIB_PKG_RDNCY_MAX
0x100L
ulPackageRedundancyDefault
VDS_POOL_ATTRIB_PKG_RDNCY_MIN
0x200L
ulPackageRedundancyMin
VDS_POOL_ATTRIB_PKG_RDNCY_DEF
0x400L
ulPackageRedundancyDefault
VDS_POOL_ATTRIB_STRIPE_SIZE
0x800L
ulStripeSize
VDS_POOL_ATTRIB_STRIPE_SIZE_MAX
0x1000L
ulStripeSizeMax
VDS_POOL_ATTRIB_STRIPE_SIZE_MIN
0x2000L
ulStripeSizeMin
VDS_POOL_ATTRIB_STRIPE_SIZE_DEF
0x4000L
ulDefaultStripeSize
VDS_POOL_ATTRIB_NUM_CLMNS
0x8000L
ulNumberOfColumns
VDS_POOL_ATTRIB_NUM_CLMNS_MAX
0x10000L
ulNumberOfColumnsMax
VDS_POOL_ATTRIB_NUM_CLMNS_MIN
0x20000L
ulNumberOfColumnsMin
VDS_POOL_ATTRIB_NUM_CLMNS_DEF
0x40000L
ulDefaultNumberofColumns
VDS_POOL_ATTRIB_DATA_AVL_HINT
0x80000L
ulDataAvailabilityHint
VDS_POOL_ATTRIB_ACCS_RNDM_HINT
0x100000L
ulAccessRandomnessHint
VDS_POOL_ATTRIB_ACCS_DIR_HINT
0x200000L
ulAccessDirectionHint
VDS_POOL_ATTRIB_ACCS_SIZE_HINT
0x400000L
ulAccessSizeHint
VDS_POOL_ATTRIB_ACCS_LTNCY_HINT
0x800000L
ulAccessLatencyHint
VDS_POOL_ATTRIB_ACCS_BDW_WT_HINT
0x1000000L
ulAccessBandwidthWeightHint
VDS_POOL_ATTRIB_STOR_COST_HINT
0x2000000L
ulStorageCostHint
VDS_POOL_ATTRIB_STOR_EFFCY_HINT
0x4000000L
ulStorageEfficiencyHint
VDS_POOL_ATTRIB_CUSTOM_ATTRIB
0x8000000L
pPoolCustomAttributes

raidType

指定存放集區 RAID 類型的 VDS_RAID_TYPE 列舉值。 如果存放集區沒有特定的 RAID 類型,請將此成員設定為VDS_RT_UNKNOWN,並清除ullAttributeMask成員中的VDS_POOL_ATTRIB_RAIDTYPE屬性旗標。

busType

VDS_STORAGE_BUS_TYPE列舉值,指定存放集區中磁片磁碟機的匯流排類型。

pwszIntendedUsage

指定儲存集區的使用方式的字串。 通常,這可能表示使用存放集區的應用程式 (例如「SQL」 或 「Exchange」) ,或是使用存放集區的商業功能 (,例如「財務」或「人力資源」) 。

bSpinDown

TRUE 是表示 如果存放集區中的磁片磁碟機自動減少電源使用量,則 為 TRUE,否則為 FALSE

bIsThinProvisioned

如果儲存集區已精簡布建,則為TRUE,否則為FALSE。 如果集區已精簡布建,集區耗用空間中的位元組數目可能會小於集區布建空間中的位元組數目。 (布建空間中的位元組數目會儲存在此結構的ullProvisionedSpace成員中。耗用空間中的位元組數目會儲存在VDS_STORAGE_POOL_PROP structure 的ullTotalConsumedSpace成員中。) 當硬體提供者將此成員設定為TRUE時,也必須將VDS_STORAGE_POOL_PROP結構的別成員設定為VDS_SPT_CONCRETE

ullProvisionedSpace

如果集區已精簡布建,此成員會指定為集區布建的空間,以位元組為單位。 這個成員的值必須大於或等於VDS_STORAGE_POOL_PROP結構的ullTotalConsumedSpace成員值。

bNoSinglePointOfFailure

如果集區中沒有單一失敗點,則為TRUE,否則為FALSE

ulDataRedundancyMax

此存放集區中可維護之資料的完整複本數目上限。

ulDataRedundancyMin

此存放集區中可維護之資料的完整複本數目下限。

ulDataRedundancyDefault

此存放集區中維護之資料的預設完整複本數目。

ulPackageRedundancyMax

可在存放集區中使用的磁片磁碟機數目上限,以確保套件備援。 套件備援表示儲存集區中可能會失敗的磁片磁碟機數目,而不會造成資料遺失。

ulPackageRedundancyMin

儲存集區中使用的磁片磁碟機數目下限,以確保套件備援。 套件備援表示儲存集區中可能會失敗的磁片磁碟機數目,而不會造成資料遺失。

ulPackageRedundancyDefault

儲存集區中使用的預設磁片磁碟機數目,以確保套件備援。 套件備援表示儲存集區中可能會失敗的磁片磁碟機數目,而不會造成資料遺失。

ulStripeSize

如果集區 (有或沒有同位) ,則鏡像或同位等位等量大小,以位元組為單位的存放集區大小。

ulStripeSizeMax

存放集區支援的等量大小上限,以位元組為單位。

ulStripeSizeMin

存放集區支援的最小等量大小,以位元組為單位。

ulDefaultStripeSize

存放集區支援的預設等量大小,以位元組為單位。

ulNumberOfColumns

如果集區具有或沒有同位) 的等量分割 (,則存放集區的資料行數目。

ulNumberOfColumnsMax

存放集區所支援的最大資料行數目。

ulNumberOfColumnsMin

存放集區所支援的資料行數目下限。

ulDefaultNumberofColumns

存放集區支援的預設資料行數目。

ulDataAvailabilityHint

用戶端的提示,指出對資料可用性的重要性。 值的範圍從 0 (不重要) 到 10 (非常重要) 。

ulAccessRandomnessHint

用戶端的提示,指出資料存取的隨機性。 值的範圍從 0 (完全循序) 到 10 (完全隨機) 。

ulAccessDirectionHint

用戶端的提示,指出資料存取的方向。 值的範圍從 0 (完全讀取) 到 10 (完全寫入) 。

ulAccessSizeHint

用戶端的提示,指出以 MB 為單位的最佳存取大小。

ulAccessLatencyHint

用戶端的提示,指出存取延遲對用戶端的重要性。 值的範圍從 0 (不重要) 到 10 (非常重要) 。

ulAccessBandwidthWeightHint

用戶端的提示,指出高頻寬的重要性。 值的範圍從 0 (不重要) 到 10 (非常重要) 。

ulStorageCostHint

用戶端的提示,指出儲存體成本對用戶端的重要性。 值的範圍從 0 (不重要) 到 10 (非常重要) 。 如果儲存體成本對用戶端而言非常重要,則值為 10 表示用戶端偏好使用較低的成本儲存體來布建集區。

ulStorageEfficiencyHint

用戶端的提示,指出儲存體效率對用戶端的重要性。 值的範圍從 0 (不重要) 到 10 (非常重要) 。

ulNumOfCustomAttributes

為存放集區定義的自訂屬性數目。

pPoolCustomAttributes

VDS_POOL_CUSTOM_ATTRIBUTES結構的陣列。 每個 結構都包含為存放集區定義的自訂屬性。

bReserved1

這個成員保留供未來使用。 請勿使用。

bReserved2

這個成員保留供未來使用。 請勿使用。

ulReserved1

這個成員保留供未來使用。 請勿使用。

ulReserved2

這個成員保留供未來使用。 請勿使用。

ullReserved1

這個成員保留供未來使用。 請勿使用。

ullReserved2

這個成員保留供未來使用。 請勿使用。

備註

如果為存放集區設定屬性,該屬性設定必須套用至組成集區的所有磁片磁碟機範圍。

規格需求

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

另請參閱

IVdsHwProviderStoragePools::QueryStoragePools

IVdsStoragePool::GetAttributes