共用方式為

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，FlagsPerfConfigData 所指向之結構的成員 包含支援的旗標。
STOR_STATUS_UNSUCCESSFUL
 迷你埠驅動程式會在 PerfConfigData 中設定旗標， Storport 無法辨識，或迷你埠驅動程式已從 miniport-driver-supplied 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