次の方法で共有


StorPortInitializePerfOpts 関数 (storport.h)

StorPortInitializePerfOpts 関数は、ミニポート ドライバーと Storport ドライバーの両方が PERF_CONFIGURATION_DATA 構造体を使用してサポートするパフォーマンスの最適化を初期化します。

構文

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

パラメーター

[in] HwDeviceExtension

ホスト バス アダプター (HBA) のハードウェア デバイス拡張機能へのポインター。 このパラメーターは NULL することはできません。

[in] Query

TRUE 設定すると、Storport でサポートされている最適化に対応する PerfConfigData でフラグが設定されます。 FALSE 設定すると、Storport は PerfConfigData のフラグで指定された最適化初期化します。

[in, out] PerfConfigData

ミニポート ドライバーによって提供されるPERF_CONFIGURATION_DATA構造体へのポインター。 このパラメーターは NULL することはできません。

戻り値

StorPortInitializePerfOpts は、次のいずれかの状態値を返します。

リターン コード 形容
STOR_STATUS_NOT_IMPLEMENTED
この関数は、アクティブなオペレーティング システムでは実装されません。
STOR_STATUS_SUCCESS
パフォーマンスの最適化設定が適用されたことを示します。

または、クエリ が TRUE 設定されている場合、PerfConfigData が指す構造体の Flags メンバーには、サポートされているフラグが含まれます。

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