英語で読む

次の方法で共有


StorPortPoFxSetPerfState 関数 (storport.h)

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

構文

C++
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 配列に N 個の要素が含まれている場合、コンポーネントインデックスの範囲は 0 から N ~ 1 です。

Flags

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

SetIndex

以前に登録されたパフォーマンス セットのインデックス。

State

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

Context

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

戻り値

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

エラー コード 意味
STOR_STATUS_INVALID_PARAMETER パラメーターの 1 つが無効です。たとえば、Address または Flags は NULL ではありません。
STOR_STATUS_UNSUCCESSFUL アダプターはアイドル検出用に登録されていません。

必要条件

要件 価値
サポートされる最小クライアント Windows 8
ヘッダー storport.h