VDS_HINTS 结构 (vdshwprv.h)

[从 Windows 8 和 Windows Server 2012 开始,虚拟磁盘服务 COM 接口由 Windows 存储管理 API 取代。]

定义 LUN 或 LUN plex 的自动磁力提示。

语法

typedef struct _VDS_HINTS {
  ULONGLONG ullHintMask;
  ULONGLONG ullExpectedMaximumSize;
  ULONG     ulOptimalReadSize;
  ULONG     ulOptimalReadAlignment;
  ULONG     ulOptimalWriteSize;
  ULONG     ulOptimalWriteAlignment;
  ULONG     ulMaximumDriveCount;
  ULONG     ulStripeSize;
  BOOL      bFastCrashRecoveryRequired;
  BOOL      bMostlyReads;
  BOOL      bOptimizeForSequentialReads;
  BOOL      bOptimizeForSequentialWrites;
  BOOL      bRemapEnabled;
  BOOL      bReadBackVerifyEnabled;
  BOOL      bWriteThroughCachingEnabled;
  BOOL      bHardwareChecksumEnabled;
  BOOL      bIsYankable;
  SHORT     sRebuildPriority;
} VDS_HINTS, *PVDS_HINTS;

成员

ullHintMask

LUN 提示掩码。 此结构的每个 BOOL 成员都有一个可在掩码中设置的相应提示标志。 如果设置了提示标志,则考虑相应的提示。 如果未设置提示标志,则忽略提示。 下表描述了提示标志。

含义
VDS_HINT_FASTCRASHRECOVERYREQUIRED
0x0000000000000001L
提供程序限制恢复所需的时间。 为了支持快速恢复,提供程序使用更改日志,使提供程序能够恢复 LUN,而无需比较 LUN 的全部内容。
VDS_HINT_MOSTLYREADS
0x0000000000000002L
提供程序针对读取最多的使用模式优化 LUN,通常使用镜像而不是奇偶校验条带化。
VDS_HINT_OPTIMIZEFORSEQUENTIALREADS
0x0000000000000004L
提供程序针对顺序读取使用模式优化 LUN。 如果未设置此标志并且也未设置VDS_HINT_OPTIMIZEFORSEQUENTIALWRITES,则 LUN 将针对随机 I/O 进行优化。
VDS_HINT_OPTIMIZEFORSEQUENTIALWRITES
0x0000000000000008L
提供程序针对顺序写入使用模式优化 LUN。 如果未设置此标志并且也未设置VDS_HINT_OPTIMIZEFORSEQUENTIALREADS,则会针对随机 I/O 优化 LUN。
VDS_HINT_READBACKVERIFYENABLED
0x0000000000000010L
提供程序使用读回验证对 LUN 的写入。
VDS_HINT_REMAPENABLED
0x0000000000000020L
提供程序会自动创建和更新 LUN 盘区到驱动器盘区的映射。 如果未设置此标志,则映射在配置后保持不变,除非采取主动操作以避免驱动器故障。
VDS_HINT_WRITETHROUGHCACHINGENABLED
0x0000000000000040L
提供程序在 LUN 上启用写通缓存策略。
VDS_HINT_HARDWARECHECKSUMENABLED
0x0000000000000080L
提供程序在 LUN 上启用硬件校验和。
VDS_HINT_ISYANKABLE
0x0000000000000100L
提供程序配置 LUN,以便可以物理删除影响 LUN 的驱动器,并将系统中断降至最低。 这通常是通过确保 LUN 占用尽可能少的驱动器来实现的。

ullExpectedMaximumSize

LUN 预期增长到的最大大小(以字节为单位)。 调用 IVdsSubSystem::CreateLun 方法时,该值可以等于、大于或小于 ullSizeInBytes 中指定的值。 某些提供程序使用此值为 LUN 保留空间。 无法保留空间的提供程序通常会忽略此参数。

ulOptimalReadSize

LUN 的最佳读取大小(以字节为单位)。 零表示没有最佳读取大小。

ulOptimalReadAlignment

与 LUN 的第一个逻辑块相关的最佳读取对齐方式。 零表示没有最佳的读取对齐方式。

ulOptimalWriteSize

LUN 的最佳写入大小(以字节为单位)。 零表示没有最佳写入大小。

ulOptimalWriteAlignment

与 LUN 的第一个逻辑块相关的最佳写入对齐方式。 零表示没有最佳的写入对齐方式。

ulMaximumDriveCount

用于 LUN 的最大驱动器数。 零表示没有最大驱动器计数。 此值可用于限制条带集中的条带交错数。

ulStripeSize

镜像或奇偶校验条带交错大小(以字节为单位)。 零将保留未指定条带大小。

bFastCrashRecoveryRequired

如果此成员为 TRUE,则恢复时间有限。 在 ullHintMask 成员中设置 VDS_HINT_FASTCRASHRECOVERYREQUIRED 标志,以指示对此成员感兴趣。

bMostlyReads

若要优化主要读取的使用模式 (例如通过镜像而不是奇偶校验条带化) ,请将此成员设置为 TRUE。 否则,请将其设置为 FALSE。 在 ullHintMask 成员中设置VDS_HINT_MOSTLYREADS标志,以指示对此成员感兴趣。

bOptimizeForSequentialReads

若要优化顺序读取使用模式,请将此成员设置为 TRUE。 否则,请将其设置为 FALSE。 将 bOptimizeForSequentialReadsbOptimizeForSequentialWrites 成员都设置为 FALSE 可针对随机 I/O 进行优化。 在 ullHintMask 成员中设置 VDS_HINT_OPTIMIZEFORSEQUENTIALREADS 标志,以指示对此成员感兴趣。

bOptimizeForSequentialWrites

若要优化顺序写入使用模式,请将 将此成员设置为 TRUE。 否则,请将其设置为 FALSE。 将 bOptimizeForSequentialReadsbOptimizeForSequentialWrites 成员都设置为 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标志以指示对此成员感兴趣。

sRebuildPriority

LUN 的重新生成优先级。 该值的范围可以是 0 (最低优先级) 到 15 (最高优先级) 。

注解

IVdsSubSystem::CreateLun 方法将此结构作为参数传递,以提供创建 LUN 的提示。 它在 IVdsLun 和 IVdsLunPlex 接口上的 ApplyHints 方法中作为参数传递,分别将一组新的提示应用于 LUN 或 LUN plex。 此外,它由 IVdsLunIVdsLunPlex 接口上的 QueryHints 方法返回,以分别报告当前应用于 LUN 或 LUN plex 的提示。

提示不是对实现者的指令。 虽然实施者通常希望尽最大努力考虑提示,但他们没有义务遵循提示。 如果由于技术原因而无法遵循指定的提示或遵循这些提示可能会导致配置不佳,则实施者可以选择替代方法。

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
标头 vdshwprv.h

另请参阅

IVdsLun::ApplyHints

IVdsLun::QueryHints

IVdsLunPlex::ApplyHints

IVdsLunPlex::QueryHints

IVdsSubSystem::CreateLun

VDS 结构