USER_POWER_POLICY構造体 (powrprof.h)

  • [アーティクル]

ユーザーの各電源スキームに固有の電源ポリシー設定が含まれます。 この構造体は、 POWER_POLICY 構造体の一部です。

構文

typedef struct _USER_POWER_POLICY {
  ULONG               Revision;
  POWER_ACTION_POLICY IdleAc;
  POWER_ACTION_POLICY IdleDc;
  ULONG               IdleTimeoutAc;
  ULONG               IdleTimeoutDc;
  UCHAR               IdleSensitivityAc;
  UCHAR               IdleSensitivityDc;
  UCHAR               ThrottlePolicyAc;
  UCHAR               ThrottlePolicyDc;
  SYSTEM_POWER_STATE  MaxSleepAc;
  SYSTEM_POWER_STATE  MaxSleepDc;
  ULONG               Reserved[2];
  ULONG               VideoTimeoutAc;
  ULONG               VideoTimeoutDc;
  ULONG               SpindownTimeoutAc;
  ULONG               SpindownTimeoutDc;
  BOOLEAN             OptimizeForPowerAc;
  BOOLEAN             OptimizeForPowerDc;
  UCHAR               FanThrottleToleranceAc;
  UCHAR               FanThrottleToleranceDc;
  UCHAR               ForcedThrottleAc;
  UCHAR               ForcedThrottleDc;
} USER_POWER_POLICY, *PUSER_POWER_POLICY;

メンバー

Revision

現在の構造リビジョン レベル。 この値を設定するには、USER_POWER_POLICY構造を使用して電源ポリシーを設定する前に、GetCurrentPowerPolicies または ReadPwrScheme を呼び出します。

IdleAc

システムが AC (ユーティリティ) 電源で実行され、システム アイドル タイマーの有効期限が切れたときに開始するシステム電源アクションを定義するPOWER_ACTION_POLICY構造。

IdleDc

システムがバッテリ電源で実行され、システムアイドル タイマーの有効期限が切れたときに開始するシステム電源アクションを定義するPOWER_ACTION_POLICY構造。

IdleTimeoutAc

AC (ユーティリティ) 電源で実行しているときにシステム アイドル タイマーの有効期限が切れる前に、システム アクティビティのレベルがアイドル状態の検出しきい値を下回る必要がある時間 (秒単位)。

ユーザーが存在しないため、システムが自動再開を実行している場合、このメンバーは無視されます。 アプリケーションがタスクの実行中にシステムを一時的に実行したままにするには、 SetThreadExecutionState 関数を使用します。

IdleTimeoutDc

システム アクティビティのレベルが、バッテリ電源で実行されている場合にシステム アイドル タイマーが切れるまでのアイドル検出しきい値を秒単位で下回る必要がある時間。

ユーザーが存在しないため、システムが自動再開を実行している場合、このメンバーは無視されます。 アプリケーションがタスクの実行中にシステムを一時的に実行したままにするには、 SetThreadExecutionState 関数を使用します。

IdleSensitivityAc

システムが AC (ユーティリティ) 電源で実行されている場合のアイドル状態の検出のしきい値を定義するシステム アクティビティのレベルをパーセンテージで表します。

IdleSensitivityDc

システムがバッテリ電源で実行されている場合のアイドル状態の検出のしきい値を定義するシステム アクティビティのレベルをパーセンテージで表します。

ThrottlePolicyAc

システムが AC (ユーティリティ) 電源で実行されているときに使用するプロセッサの動的調整ポリシー。

ThrottlePolicyDc

システムがバッテリ電源で実行されているときに使用するプロセッサの動的調整ポリシー。

MaxSleepAc

システムが AC (ユーティリティ) 電源で実行されている場合の最大システム スリープ状態。 このメンバーは、 SYSTEM_POWER_STATE 列挙型の値のいずれかである必要があります。

MaxSleepDc

システムがバッテリ電源で実行されている場合の最大システム スリープ状態。 このメンバーは、 SYSTEM_POWER_STATE 列挙型の値のいずれかである必要があります。

Reserved[2]

予約済み。

VideoTimeoutAc

システムが AC (ユーティリティ) 電源で実行されているときに、ディスプレイがオフになるまでの時間 (秒単位)。

VideoTimeoutDc

システムがバッテリ電源で動作しているとき、ディスプレイがオフになるまでの時間 (秒単位)。

SpindownTimeoutAc

システムが AC (ユーティリティ) 電源 (秒単位) で実行されているときに、固定ディスク ドライブへの電源がオフになるまでの時間。

SpindownTimeoutDc

システムがバッテリ電源で実行されているときに、固定ディスク ドライブの電源がオフになるまでの時間 (秒単位)。

OptimizeForPowerAc

このメンバーが TRUE の場合、パッシブ冷却が指定され、システムが AC (ユーティリティ) 電源で実行されている場合、システムは冷却ファンをオンにし、プロセッサをフルスピードで実行します。 これにより、オペレーティング システムがファンを使用し、プロセッサをフル スピードで実行するようにバイアスされます。

OptimizeForPowerDc

このメンバーが TRUE の場合、パッシブ冷却が指定され、システムがバッテリ電源で実行されている場合、システムは冷却ファンをオンにし、プロセッサをフルスピードで実行します。 これにより、オペレーティング システムがファンを使用し、プロセッサをフル スピードで実行するようにバイアスされます。

FanThrottleToleranceAc

システムが AC (ユーティリティ) 電源で動作している間に、温度イベントに応じてシステム ファンをオンにする前にプロセッサが調整される可能性がある下限 。パーセンテージで表されます。

FanThrottleToleranceDc

システムがバッテリ電源で動作している間に、温度イベントに応じてシステム ファンをオンにする前にプロセッサが調整される可能性がある下限 。パーセンテージで表されます。

ForcedThrottleAc

コンピューターが AC (ユーティリティ) 電源で実行されている間にシステムによって課されるプロセッサスロットル レベル 。パーセンテージで表されます。

ForcedThrottleDc

コンピューターがバッテリ電源で実行されている間にシステムによって課されるプロセッサ スロットル レベル (パーセンテージで表されます)。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
Header powrprof.h

こちらもご覧ください

POWER_ACTION_POLICY

POWER_POLICY