(vdshwprv.h) VDS_POOL_ATTRIBUTES 结构
[从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
一个VDS_RAID_TYPE枚举值，该值指定存储池的 RAID 类型。 如果存储池没有特定的 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结构的 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 [仅限桌面应用] |
| 标头 | vdshwprv.h |
另请参阅
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈