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 を含む)

こちらもご覧ください

CallNtPowerInformation

POWER_ACTION_POLICY

SYSTEM_POWER_LEVEL