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 |