通过

StorPortInitializePerfOpts 函数 （storport.h）

  • 项目

StorPortInitializePerfOpts 函数使用 PERF_CONFIGURATION_DATA 结构初始化微型端口驱动程序和 Storport 驱动程序支持的性能优化。

语法

ULONG StorPortInitializePerfOpts(
  [in]      PVOID                    HwDeviceExtension,
  [in]      BOOLEAN                  Query,
  [in, out] PPERF_CONFIGURATION_DATA PerfConfigData
);

参数

[in] HwDeviceExtension

指向主机总线适配器（HBA）的硬件设备扩展的指针。 此参数不得 NULL。

[in] Query

如果设置为 TRUE，Storport 将在与 Storport 支持的优化相对应的 PerfConfigData 中设置标志。 如果设置为 FALSE，Storport 将在 PerfConfigData中初始化标志指定的优化。

[in, out] PerfConfigData

指向微型端口驱动程序提供的PERF_CONFIGURATION_DATA结构的指针。 此参数不得 NULL。

返回值

StorPortInitializePerfOpts 返回以下状态值之一：

返回代码 描述
STOR_STATUS_NOT_IMPLEMENTED
 此函数未在活动作系统上实现。
STOR_STATUS_SUCCESS
 指示已应用性能优化设置。

或者，如果 查询 设置为 TRUE，则 PerfConfigData 指向的结构 标志 成员包含支持的标志。
STOR_STATUS_UNSUCCESSFUL
 微型端口驱动程序在 Storport 无法识别 PerfConfigData 中设置一个标志，或者微型端口驱动程序已从微型端口驱动程序提供的 HwStorInitialize 例程外部调用此例程。
STOR_STATUS_INSUFFICIENT_RESOURCES
 无法分配内部结构以支持请求的优化。
STOR_STATUS_INVALID_PARAMETER
 HwDeviceExtension 参数或 PerfConfigData 参数 NULL。

言论

微型端口驱动程序只能在微型端口提供的 HwStorInitialize 例程或 HwStorPassiveInitializeRoutine 例程期间调用 StorPortInitializePerfOpts。

可用的性能优化取决于 PERF_CONFIGURATION_DATA的版本。 将 版本 成员设置为 STOR_PERF_VERSION 将允许选择所有受支持的优化。

要求

要求 价值
目标平台 普遍
标头 storport.h （包括 Storport.h）
DDI 符合性规则 StorPortPerfOpts（storport）

另请参阅

PERF_CONFIGURATION_DATA