VDS_HINTS 结构 (vds.h)

项目
03/08/2023

[从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，则针对随机 I/O 优化 LUN。
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。将 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 由几个驱动器) 的盘区组成时，通常如此。如果为 FALSE，则无法在不对系统造成重大中断的情况下删除 LUN。在 ullHintMask 成员中设置VDS_HINT_ISYANKABLE标志，以指示对此成员的兴趣。

sRebuildPriority

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

备注

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

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