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 は、次のいずれかの状態値を返します。
リターン コード | 形容 |
---|---|
|
この関数は、アクティブなオペレーティング システムでは実装されません。 |
|
パフォーマンスの最適化設定が適用されたことを示します。
または、クエリ が TRUE 設定されている場合、PerfConfigData が指す構造体の Flags メンバーには、サポートされているフラグが含まれます。 |
|
ミニポート ドライバーは、Storport が認識しなかった PerfConfigData フラグを設定します。または、ミニポート ドライバーは、ミニポート ドライバー提供の HwStorInitialize ルーチンの外部からこのルーチンを呼び出しました。 |
|
要求された最適化をサポートするために内部構造を割り当てることができません。 |
|
HwDeviceExtension パラメーターまたは PerfConfigData パラメーターが NULL されました。 |
備考
ミニポート ドライバーは、ミニポート提供の HwStorInitialize ルーチンまたは hwStorPassiveInitializeRoutine ルーチン 中にのみ、StorPortInitializePerfOpts 呼び出すことができます。
使用可能なパフォーマンスの最適化は、PERF_CONFIGURATION_DATAのバージョンによって異なります。 バージョン メンバーを STOR_PERF_VERSION に設定すると、サポートされているすべての最適化を選択できます。
必要条件
要件 | 価値 |
---|---|
ターゲット プラットフォーム の | 万国 |
ヘッダー | storport.h (Storport.h を含む) |
DDI コンプライアンス規則 を する | StorPortPerfOpts(storport) の |