VDS_POOL_ATTRIBUTES 結構 (vdshwprv.h)

發行項
03/13/2024

[從 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，否則為 FALSE 。

bIsThinProvisioned

如果儲存集區已精簡布建，則為TRUE，否則為 FALSE。如果集區已精簡布建，集區耗用空間中的位元元組數目可能會小於集區布建空間中的位元組數目。 (布建空間中的位元組數目會儲存在此結構的 ullProvisionedSpace 成員中。耗用空間中的位元組數目會儲存在 VDS_STORAGE_POOL_PROP structure 的 ullTotalConsumedSpace 成員中。) 當硬體提供者將此成員設定為 TRUE 時，也必須將VDS_STORAGE_POOL_PROP結構的 type 成員設定為 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 [僅限桌面應用程式]
標頭	vdshwprv.h

另請參閱

IVdsHwProviderStoragePools：：QueryStoragePools

IVdsStoragePool：：GetAttributes

共用方式為

VDS_POOL_ATTRIBUTES 結構 (vdshwprv.h)

語法

成員

備註

規格需求

另請參閱

意見反應

意見反應

其他資源