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
 パフォーマンスの最適化設定が適用されたことを示します。

または、Query が 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のバージョンによって異なります。 Version メンバーを STOR_PERF_VERSION に設定すると、サポートされているすべての最適化を選択できます。

要件

要件 値
対象プラットフォーム ユニバーサル
Header storport.h (Storport.h を含む)
DDI コンプライアンス規則 StorPortPerfOpts(storport)

こちらもご覧ください

PERF_CONFIGURATION_DATA