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 将在 PerfConfigData 中设置与 Storport 支持的优化相对应的标志。 如果设置为 FALSE，Storport 将初始化 PerfConfigData 中的标志指定的优化。

[in, out] PerfConfigData

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

返回值

StorPortInitializePerfOpts 返回以下状态值之一：

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

或者，如果 Query 设置为 TRUE，则 PerfConfigData 指向的结构的 Flags 成员将包含支持的标志。
STOR_STATUS_UNSUCCESSFUL
 微型端口驱动程序在 PerfConfigData 中设置 Storport 无法识别的标志，或者微型端口驱动程序已从微型端口驱动程序提供的 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