VDS_HINTS2 结构 (vdshwprv.h)
[从 Windows 8 和 Windows Server 2012 开始，虚拟磁盘服务 COM 接口由 Windows 存储管理 API 取代。]
包含 存储池中 LUN 的自动提示。
语法
typedef struct _VDS_HINTS2 {
ULONGLONG ullHintMask;
ULONGLONG ullExpectedMaximumSize;
ULONG ulOptimalReadSize;
ULONG ulOptimalReadAlignment;
ULONG ulOptimalWriteSize;
ULONG ulOptimalWriteAlignment;
ULONG ulMaximumDriveCount;
ULONG ulStripeSize;
ULONG ulReserved1;
ULONG ulReserved2;
ULONG ulReserved3;
BOOL bFastCrashRecoveryRequired;
BOOL bMostlyReads;
BOOL bOptimizeForSequentialReads;
BOOL bOptimizeForSequentialWrites;
BOOL bRemapEnabled;
BOOL bReadBackVerifyEnabled;
BOOL bWriteThroughCachingEnabled;
BOOL bHardwareChecksumEnabled;
BOOL bIsYankable;
BOOL bAllocateHotSpare;
BOOL bUseMirroredCache;
BOOL bReadCachingEnabled;
BOOL bWriteCachingEnabled;
BOOL bMediaScanEnabled;
BOOL bConsistencyCheckEnabled;
VDS_STORAGE_BUS_TYPE BusType;
BOOL bReserved1;
BOOL bReserved2;
BOOL bReserved3;
SHORT sRebuildPriority;
} VDS_HINTS2, *PVDS_HINTS2;
成员
ullHintMask
LUN 提示掩码。 此结构的每个 BOOL 成员都有一个可在掩码中设置的相应提示标志。 如果设置了提示标志，则考虑相应的提示。 如果未设置提示标志，则忽略提示。 下表描述了提示标志。
| 值 | 含义 |
|---|---|
|
提供程序限制恢复所需的时间。 为了支持快速恢复，提供程序使用更改日志，使提供程序能够恢复 LUN，而无需比较 LUN 的全部内容。 |
|
提供程序针对读取最多的使用模式优化 LUN，通常使用镜像而不是奇偶校验条带化。 |
|
提供程序针对顺序读取使用模式优化 LUN。 如果未设置此标志并且也未设置VDS_HINT_OPTIMIZEFORSEQUENTIALWRITES，则 LUN 将针对随机 I/O 进行优化。 |
|
提供程序针对顺序写入使用模式优化 LUN。 如果未设置此标志并且也未设置VDS_HINT_OPTIMIZEFORSEQUENTIALREADS，则会针对随机 I/O 优化 LUN。 |
|
提供程序使用读回验证对 LUN 的写入。 |
|
提供程序会自动创建和更新 LUN 盘区到驱动器盘区的映射。 如果未设置此标志，则映射在配置后保持不变，除非采取主动操作以避免驱动器故障。 |
|
提供程序在 LUN 上启用写通缓存策略。 |
|
提供程序在 LUN 上启用硬件校验和。 |
|
提供程序配置 LUN，以便可以物理删除影响 LUN 的驱动器，并将系统中断降到最低。 这通常是通过确保 LUN 占用尽可能少的驱动器来实现的。 |
|
提供程序为 LUN 分配热备用。 有关详细信息，请参阅 热存储、 VDS_DRIVE_FLAG和 VDS_DISK_FLAG。 |
|
提供程序在 LUN 上使用指定的总线类型。 有关详细信息，请参阅 VDS_STORAGE_BUS_TYPE。 |
|
提供程序在 LUN 上使用镜像缓存。 请参阅 VDS_SUB_SYSTEM_FLAG 枚举的 VDS_SF_SUPPORTS_MIRRORED_CACHE 值。 |
|
提供程序在 LUN 上启用读取缓存。 请参阅 VDS_LUN_FLAG 枚举的 VDS_LF_READ_CACHE_ENABLED 值和 VDS_SUB_SYSTEM_FLAG 枚举的 VDS_SF_READ_CACHING_CAPABLE 值。 |
|
提供程序在 LUN 上启用写入缓存。 请参阅 VDS_LUN_FLAG 枚举的 VDS_LF_WRITE_CACHE_ENABLED 值和 VDS_SUB_SYSTEM_FLAG 枚举的 VDS_SF_WRITE_CACHING_CAPABLE 值。 |
|
提供程序在 LUN 上启用媒体扫描。 请参阅 VDS_LUN_FLAG 枚举的 VDS_LF_MEDIA_SCAN_ENABLED 值和 VDS_SUB_SYSTEM_FLAG 枚举的 VDS_SF_MEDIA_SCAN_CAPABLE 值。 |
|
提供程序在 LUN 上启用一致性检查。 请参阅VDS_LUN_FLAG枚举的VDS_LF_CONSISTENCY_CHECK_ENABLED值和VDS_SUB_SYSTEM_FLAG枚举的VDS_SF_CONSISTENCY_CHECK_CAPABLE值。 |
ullExpectedMaximumSize
LUN 预期增长到的最大大小（以字节为单位）。 当调用 IVdsHwProviderStoragePools：：CreateLunInStoragePool 方法时，该值可以等于、大于或小于 ullSizeInBytes 参数中指定的值。 某些提供程序使用此值为 LUN 保留空间。 无法保留空间的提供程序通常会忽略此参数。
ulOptimalReadSize
LUN 的最佳读取大小（以字节为单位）。 零表示没有最佳读取大小。
ulOptimalReadAlignment
与 LUN 的第一个逻辑块相关的最佳读取对齐方式。 零表示没有最佳的读取对齐方式。
ulOptimalWriteSize
LUN 的最佳写入大小（以字节为单位）。 零表示没有最佳写入大小。
ulOptimalWriteAlignment
与 LUN 的第一个逻辑块相关的最佳写入对齐方式。 零表示没有最佳的写入对齐方式。
ulMaximumDriveCount
用于 LUN 的最大驱动器数。 零表示没有最大驱动器计数。 此值可用于限制条带集中的条带交错数。
ulStripeSize
镜像或奇偶校验条带交错大小（以字节为单位）。 零将保留未指定条带大小。
ulReserved1
此成员留待将来使用。 请勿使用。
ulReserved2
此成员留待将来使用。 请勿使用。
ulReserved3
此成员留待将来使用。 请勿使用。
bFastCrashRecoveryRequired
如果此成员为 TRUE，则恢复时间有限。 在 ullHintMask 成员中设置 VDS_HINT_FASTCRASHRECOVERYREQUIRED 标志，以指示对此成员感兴趣。
bMostlyReads
若要优化主要读取 (使用模式，例如通过镜像而不是奇偶校验条带化) ，请将此成员设置为 TRUE。 否则，请将其设置为 FALSE。 在 ullHintMask 成员中设置VDS_HINT_MOSTLYREADS标志以指示对此成员的兴趣。
bOptimizeForSequentialReads
若要优化顺序读取使用模式，请将此成员设置为 TRUE。 否则，请将其设置为 FALSE。 将 bOptimizeForSequentialReads 和 bOptimizeForSequentialWrites 成员都设置为 FALSE 针对随机 I/O 进行 优化 。 在 ullHintMask 成员中设置VDS_HINT_OPTIMIZEFORSEQUENTIALREADS标志以指示对此成员的兴趣。
bOptimizeForSequentialWrites
若要针对顺序写入使用模式进行优化，请将此成员设置为 TRUE。 否则，请将其设置为 FALSE。 将 bOptimizeForSequentialReads 和 bOptimizeForSequentialWrites 成员都设置为 FALSE 针对随机 I/O 进行 优化 。 在 ullHintMask 成员中设置VDS_HINT_OPTIMIZEFORSEQUENTIALWRITES标志以指示对此成员的兴趣。
bRemapEnabled
如果此成员为 TRUE，提供程序会自动将 LUN 盘区重新映射到驱动器盘区。 如果为 FALSE，则 LUN 盘区到驱动器盘区的映射在 LUN 配置后将保持不变，除非显式重新映射盘区以避免损坏的块。 在 ullHintMask 成员中设置VDS_HINT_REMAPENABLED标志以指示对此成员的兴趣。
bReadBackVerifyEnabled
如果此成员为 TRUE，则提供程序通过读回验证对 LUN 的写入。 如果为 FALSE，则提供程序不会验证写入。 在 ullHintMask 成员中设置VDS_HINT_READBACKVERIFYENABLED标志以指示对此成员的兴趣。
bWriteThroughCachingEnabled
如果此成员为 TRUE，则提供程序在 LUN 上启用写式缓存;如果为 FALSE，则提供程序不启用直通写缓存。 在 ullHintMask 成员中设置VDS_HINT_WRITETHROUGHCACHINGENABLED标志以指示对此成员的兴趣。
bHardwareChecksumEnabled
如果此成员为 TRUE，则提供程序会在 LUN 上启用校验和。 在 ullHintMask 成员中设置VDS_HINT_HARDWARECHECKSUMENABLED标志以指示对此成员的兴趣。
bIsYankable
如果此成员为 TRUE，则可以在物理上删除影响 LUN 的驱动器，而不会对系统造成重大中断 (当 LUN 由几个驱动器) 的盘区组成时，这通常为 true。 如果为 FALSE，则无法在不对系统造成重大中断的情况下删除 LUN。 在 ullHintMask 成员中设置VDS_HINT_ISYANKABLE标志，以指示对此成员的兴趣。
bAllocateHotSpare
如果客户端要为此 LUN 分配热备用驱动器，则为 TRUE;否则为 FALSE。 在 ullHintMask 成员中设置VDS_HINT_ALLOCATEHOTSPARE标志以指示对此成员的兴趣。
bUseMirroredCache
如果客户端希望此 LUN 使用镜像缓存，则为 TRUE;否则为 FALSE。 在 ullHintMask 成员中设置VDS_HINT_USEMIRROREDCACHE标志以指示对此成员的兴趣。
bReadCachingEnabled
如果客户端希望 LUN 使用读取缓存，则为 TRUE;否则为 FALSE。 在 ullHintMask 成员中设置VDS_HINT_READCACHINGENABLED标志以指示对此成员的兴趣。
bWriteCachingEnabled
如果客户端希望 LUN 使用写入缓存，则为 TRUE;否则为 FALSE。 在 ullHintMask 成员中设置VDS_HINT_WRITECACHINGENABLED标志以指示对此成员的兴趣。
bMediaScanEnabled
如果客户端想要为此 LUN 启用媒体扫描，则为 TRUE;否则为 FALSE。 在 ullHintMask 成员中设置VDS_HINT_MEDIASCANENABLED标志以指示对此成员的兴趣。
bConsistencyCheckEnabled
如果客户端想要为此 LUN 启用一致性检查，则为 TRUE;否则为 FALSE。 在 ullHintMask 成员中设置VDS_HINT_CONSISTENCYCHECKENABLED标志以指示对此成员的兴趣。
BusType
一个VDS_STORAGE_BUS_TYPE枚举值，该值指定 LUN 的总线类型。 在 ullHintMask 成员中设置VDS_HINT_BUSTYPE标志以指示对此成员的兴趣。
bReserved1
此成员留待将来使用。 请勿使用。
bReserved2
此成员留待将来使用。 请勿使用。
bReserved3
此成员留待将来使用。 请勿使用。
sRebuildPriority
LUN 的重新生成优先级。 该值的范围可以是 0 (最低优先级) 到 15 (最高优先级) 。
注解
IVdsHwProviderStoragePools：：CreateLunInStoragePool 方法将此结构作为参数传递，以提供在存储池中创建 LUN 的提示。 它作为 参数在 IVdsLun2：：ApplyHints2 方法中传递，以将一组新的提示应用于 LUN。 此外， 它由 IVdsLun2：：QueryHints2 方法返回，以分别报告当前应用于 LUN 或 LUN plex 的提示。
提示不是对实现者的指令。 虽然实施者通常希望尽最大努力考虑提示，但他们没有义务遵循提示。 如果由于技术原因而无法遵循指定的提示，或者当遵循这些提示可能会导致配置不佳时，实现者可以选择替代项。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 7 [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2008 R2 [仅限桌面应用] |
| 标头 | vdshwprv.h |