winnt.h) (SYSTEM_POWER_POLICY 結構

包含目前系統電源原則的相關信息。

語法

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

最大電源狀態 (最高 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 ， 則將使用 ReducedLatencySleep 來取代 MaxSleep。

WinLogonFlags

此成員可以是零或WINLOGON_LOCK_ON_SLEEP (0x00000001) 。

Spare3

保留的。

DozeS4Timeout

進入暫停狀態和進入休眠睡眠狀態之間等待的時間，以秒為單位。 值為零表示永不休眠。

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 [僅限桌面應用程式]
標頭	winnt.h (包含 Windows.h)

另請參閱

CallNtPowerInformation

POWER_ACTION_POLICY

SYSTEM_POWER_LEVEL