VDS_POOL_ATTRIBUTES 結構 (vdshwprv.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 結構中的成員。 未使用的位是保留的。
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 |