共用方式為

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 會傳回下列其中一個狀態值：

傳回碼 Description
STOR_STATUS_NOT_IMPLEMENTED
 此函式不會在作用中的操作系統上實作。
STOR_STATUS_SUCCESS
 表示已套用效能優化設定。

或者，如果 Query 設定為 TRUE，則 PerfConfigData 所指向結構的 Flags 成員包含支援的旗標。
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的版本。 將 Version 成員設定為 STOR_PERF_VERSION 將允許選取所有支援的優化。

規格需求

需求 值
目標平台 Universal
標頭 storport.h (包含 Storport.h)
DDI 合規性規則 StorPortPerfOpts (storport)

另請參閱

PERF_CONFIGURATION_DATA