PERF_CONFIGURATION_DATA 结构 (storport.h)

  • 项目

PERF_CONFIGURATION_DATA结构描述了 StorPortInitializePerfOpts 例程支持的性能优化。

语法

typedef struct _PERF_CONFIGURATION_DATA {
  ULONG           Version;
  ULONG           Size;
  ULONG           Flags;
  ULONG           ConcurrentChannels;
  ULONG           FirstRedirectionMessageNumber;
  ULONG           LastRedirectionMessageNumber;
  ULONG           DeviceNode;
  ULONG           Reserved;
  PGROUP_AFFINITY MessageTargets;
} PERF_CONFIGURATION_DATA, *PPERF_CONFIGURATION_DATA;

成员

Version

结构的版本号。 查询和初始化优化时设置此成员。

Size

结构的大小，设置为 size of (PERF_CONFIGURATION_DATA) 。

Flags

支持的标志的按位 OR。 目前支持以下标志：

标志 含义
STOR_PERF_DPC_REDIRECTION 此标志用于指示 DPC 处理应分散到多个 CPU。

当 版本 设置为 2 或 3 时，此标志有效。
STOR_PERF_CONCURRENT_CHANNELS 此标志用于指示支持对 HwStorStartIo 例程的并发调用。 在Windows 8之前，微型端口不得设置此标志。

当 版本 设置为 2 或 3 时，此标志有效。
STOR_PERF_INTERRUPT_MESSAGE_RANGES 此标志用于指示支持中断重定向。 使用此标志时，还必须设置STOR_PERF_DPC_REDIRECTION标志。

当 版本 设置为 2 或 3 时，此标志有效。
STOR_PERF_ADV_CONFIG_LOCALITY 此标志用于指示应使用与具有正确相关性的消息组相关的组和掩码。 使用此标志时，还必须设置STOR_PERF_INTERRUPT_MESSAGE_RANGES和STOR_PERF_DPC_REDIRECTION标志。

当 版本 设置为 3 时，此标志有效。
STOR_PERF_OPTIMIZE_FOR_COMPLETION_DURING_STARTIO 此标志用于指示微型端口驱动程序将在提交新 I/O 的同时完成 I/O。 使用此标志时，还必须设置STOR_PERF_DPC_REDIRECTION标志。

当 版本 设置为 3 时，此标志有效。 请参阅下面的备注。
STOR_PERF_DPC_REDIRECTION_CURRENT_CPU 此标志用于指示你选择加入 DPC 重定向 (所需的) 但 IO 重定向选项设置为请求 DPC 的 CPU，而不是将 IO 请求发起到 Storport 的 CPU。

使用此标志时，还必须设置STOR_PERF_DPC_REDIRECTION标志。

当 版本 设置为 4 时，此标志有效。
STOR_PERF_NO_SGL 此标志用于指示微型端口不需要由 IO 请求缓冲区的存储驱动程序创建 SDL。

当 版本 设置为 5 时，此标志有效。

ConcurrentChannels

微型端口驱动程序和设备支持的 对 HwStorStartIo 例程的并发调用数。 仅当已设置STOR_PERF_CONCURRENT_CHANNELS标志时，才会访问此成员。 在Windows 8之前，微型端口不得设置此值。

FirstRedirectionMessageNumber

当 Flags 成员设置了 STOR_PERF_INTERRUPT_MESSAGE_RANGES 标志时，微型端口驱动程序会初始化中断重定向，以从此消息号开始。 仅当设置了STOR_PERF_INTERRUPT_MESSAGE_RANGES标志时，才访问此成员。

LastRedirectionMessageNumber

当 Flags 成员设置了 STOR_PERF_INTERRUPT_MESSAGE_RANGES 标志时，微型端口驱动程序会初始化中断重定向，以以此消息号结尾。 仅当设置了STOR_PERF_INTERRUPT_MESSAGE_RANGES标志时，才访问此成员。

DeviceNode

当 Flags 成员设置了 STOR_PERF_ADV_CONFIG_LOCALITY 标志时，Storport 会初始化此字段，以包含微型端口驱动程序的设备所在的 NUMA 节点编号。

Reserved

预留给系统使用。

MessageTargets

当 Flags 成员设置了 STOR_PERF_ADV_CONFIG_LOCALITY 标志时，Storport 在 GROUP_AFFINITY 数组的结构中初始化 的字段。 这些结构对应于当前正在使用的重定向消息。 数组本身是从零开始的，但 FirstRedirectionMessageNumber 不需要为零。 微型端口分配此数组，并将 MessageTargets 设置为指向它。 微型端口驱动程序必须分配一个 足够大的GROUP_AFFINITY 数组，以容纳所有返回的关联掩码。

注解

此结构的当前版本由 STOR_PERF_VERSION 定义。 将 “版本” 设置为此值将允许 Flags 指定所有支持的优化。

STOR_PERF_DPC_REDIRECTION标志的目的是确保单个 CPU 不会因 DPC 处理而过载。 设置此标志后，DPC 处理将分散在多个 CPU 上。 如果未设置STOR_PERF_DPC_REDIRECTION_CURRENT_CPU，StorPort 将尝试在产生 I/O 的同一 CPU 上计划 I/O 完成 DPC。

通常，微型端口在 HwStorStartIo 例程中完成 I/O 请求，并使用 RequestComplete 通知类型调用 StorPortNotification。 为了以这种方式处理 I/O，微型端口将保留 Flags 成员中设置STOR_PERF_OPTIMIZE_FOR_COMPLETION_DURING_STARTIO标志，从而允许 Storport 调整 DPC 重定向。

有关为设备启用消息信号中断的信息，请参阅 在注册表中启用 Message-Signaled 中断。

要求

要求 值
Header storport.h (包括 Storport.h)

另请参阅

StorPortInitializePerfOpts