SYSTEM_POWER_POLICY 構造体 (winnt.h)
現在のシステム電源ポリシーに関する情報が含まれています。
構文
typedef struct _SYSTEM_POWER_POLICY {
DWORD Revision;
POWER_ACTION_POLICY PowerButton;
POWER_ACTION_POLICY SleepButton;
POWER_ACTION_POLICY LidClose;
SYSTEM_POWER_STATE LidOpenWake;
DWORD Reserved;
POWER_ACTION_POLICY Idle;
DWORD IdleTimeout;
BYTE IdleSensitivity;
BYTE DynamicThrottle;
BYTE Spare2[2];
SYSTEM_POWER_STATE MinSleep;
SYSTEM_POWER_STATE MaxSleep;
SYSTEM_POWER_STATE ReducedLatencySleep;
DWORD WinLogonFlags;
DWORD Spare3;
DWORD DozeS4Timeout;
DWORD BroadcastCapacityResolution;
SYSTEM_POWER_LEVEL DischargePolicy[NUM_DISCHARGE_POLICIES];
DWORD VideoTimeout;
BOOLEAN VideoDimDisplay;
DWORD VideoReserved[3];
DWORD SpindownTimeout;
BOOLEAN OptimizeForPower;
BYTE FanThrottleTolerance;
BYTE ForcedThrottle;
BYTE MinThrottle;
POWER_ACTION_POLICY OverThrottled;
} SYSTEM_POWER_POLICY, *PSYSTEM_POWER_POLICY;
メンバー
Revision
現在の構造体のリビジョン。
PowerButton
システム電源ボタンが押されたときに開始するシステム電源アクションを定義するPOWER_ACTION_POLICY構造体。
SleepButton
システム スリープ ボタンが押されたときに開始するシステム電源アクションを定義するPOWER_ACTION_POLICY構造体。
LidClose
システム蓋スイッチが閉じられたときに開始するシステム電源アクションを定義する POWER_ACTION_POLICY 構造体。
LidOpenWake
lid-open イベントがシステムをスリープ解除する必要がある最大電力状態 (最大 Sx 値)。 このメンバーは、 SYSTEM_POWER_STATE 列挙型の値のいずれかである必要があります。
Reserved
予約済み。
Idle
システム アイドル タイマーの有効期限が切れたときに開始するシステム電源アクションを定義する POWER_ACTION_POLICY 構造体。
IdleTimeout
システム アイドル タイマーの有効期限が切れる前に、システム アクティビティのレベルがアイドル状態の検出しきい値を下回る必要がある時間 (秒単位)。
IdleSensitivity
アイドル状態の検出のしきい値を定義するシステム アクティビティのレベルをパーセンテージで表します。
DynamicThrottle
現在のシステム プロセッサの動的調整ポリシー。 このメンバーは、「 プロセッサ パフォーマンス制御ポリシー定数」で説明されている値のいずれかである必要があります。
Spare2[2]
予約済み。
MinSleep
現在サポートされている最小システム スリープ状態 (最低 Sx 値)。 このメンバーは、 SYSTEM_POWER_STATE 列挙型の値のいずれかである必要があります。
MaxSleep
現在サポートされている最大システム スリープ状態 (最大 Sx 値)。 このメンバーは、 SYSTEM_POWER_STATE 列挙型の値のいずれかである必要があります。
ReducedLatencySleep
未解決の待機時間要件がある場合にシステム スリープ アクションに入力するシステム電源状態 (Sx 値)。 このメンバーは、 SYSTEM_POWER_STATE 列挙型の値のいずれかである必要があります。 アプリケーションがLT_LOWEST_LATENCYを使用して RequestWakeupLatency を呼び出した場合、MaxSleep の代わりに ReducedLatencySleep が使用されます。
WinLogonFlags
このメンバーには、0 または WINLOGON_LOCK_ON_SLEEP (0x00000001) を指定できます。
Spare3
予約済み。
DozeS4Timeout
中断状態に入ってから休止状態になるまでの待機時間 (秒単位)。 値が 0 の場合、休止状態になることはないことを示します。
BroadcastCapacityResolution
システムの電源状態が変更されたイベントをシステムに通知する必要がある、現在のバッテリ容量の変更の解決。
DischargePolicy[NUM_DISCHARGE_POLICIES]
システム バッテリ放電イベントで実行するアクションを定義する SYSTEM_POWER_LEVEL 構造体の配列。
VideoTimeout
ディスプレイがオフになるまでの時間 (秒単位)。
VideoDimDisplay
このメンバーが TRUE の場合、システムにはディスプレイの淡色表示のサポートが含まれます。
VideoReserved[3]
予約済み。
SpindownTimeout
固定ディスク ドライブの電源がオフになるまでの時間 (秒単位)。
OptimizeForPower
このメンバーが TRUE の場合、システムは冷却ファンをオンにし、パッシブ冷却が指定されている場合にプロセッサを全速度で実行します。 これにより、オペレーティング システムがファンを使用し、プロセッサをフルスピードで実行するようにバイアスされます。
FanThrottleTolerance
温度イベントに応答してシステム ファンをオンにする前にプロセッサが調整される可能性がある下限 。パーセンテージで表されます。
ForcedThrottle
システムによって課されるプロセッサスロットルレベルをパーセンテージで表します。
MinThrottle
プロセッサの最小スロットル レベル 。パーセンテージで表されます。
OverThrottled
プロセッサ の調整 でシステム温度を適切に下げることができない場合に、温度イベントに応答して開始するシステム電源アクションを定義するPOWER_ACTION_POLICY構造体。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| Header | winnt.h (Windows.h を含む) |