StorPortPoFxSetPerfState 関数 (storport.h)

StorPortPoFxSetPerfState は、コンポーネントの P 状態 (パフォーマンスまたは "perf" 状態) を設定します。

構文

ULONG StorPortPoFxSetPerfState(
  PVOID         HwDeviceExtension,
  PSTOR_ADDRESS Address,
  ULONG         Component,
  ULONG         Flags,
  ULONG         SetIndex,
  ULONG         State,
  PVOID         Context
);

パラメーター

HwDeviceExtension

ミニポートのデバイス拡張機能へのポインター。

Address

登録されているデバイスのアドレス。 現時点ではアダプターのみがサポートされているため、 アドレス は NULL である必要があります。

Component

P 状態が管理されるコンポーネントを識別するインデックス。 このパラメーターは、Storport PoFx サポート用にデバイスを登録するためにミニポートが使用するSTOR_POFX_DEVICE構造体の Components配列へのインデックスです。 Components 配列に N 個の要素が含まれている場合、コンポーネントインデックスの範囲は 0 から N ~ 1 です。

Flags

現在、NULL に設定する必要があります。

SetIndex

以前に登録された perf セットのインデックス。

State

perf セットに個別の P-States が含まれている場合、これはインデックス値である必要があります。 perf セットが範囲の場合、これはその範囲内の値である必要があります。

Context

perf セット変更コールバックに渡される任意のコンテキスト。

戻り値

StorPortPoFxSetPerfState は、正常に完了した場合、または実行時電源が無効になっている場合、または次のいずれかのエラー コードがSTOR_STATUS_SUCCESSを返します。

エラー コード	意味
STOR_STATUS_INVALID_PARAMETER	いずれかのパラメーターが無効です。たとえば、 アドレス または フラグ は NULL ではありません。
STOR_STATUS_UNSUCCESSFUL	アダプターはアイドル状態の検出に登録されていません。

要件

要件	値
サポートされている最小のクライアント	Windows 8
Header	storport.h