MACHINE_POWER_POLICY 結構 (powrprof.h)
包含計算機上每個電源配置唯一的計算機電源原則設定。 這個結構是 POWER_POLICY 結構的一部分。
語法
typedef struct _MACHINE_POWER_POLICY {
ULONG Revision;
SYSTEM_POWER_STATE MinSleepAc;
SYSTEM_POWER_STATE MinSleepDc;
SYSTEM_POWER_STATE ReducedLatencySleepAc;
SYSTEM_POWER_STATE ReducedLatencySleepDc;
ULONG DozeTimeoutAc;
ULONG DozeTimeoutDc;
ULONG DozeS4TimeoutAc;
ULONG DozeS4TimeoutDc;
UCHAR MinThrottleAc;
UCHAR MinThrottleDc;
UCHAR pad1[2];
POWER_ACTION_POLICY OverThrottledAc;
POWER_ACTION_POLICY OverThrottledDc;
} MACHINE_POWER_POLICY, *PMACHINE_POWER_POLICY;
成員
Revision
目前的結構修訂層級。 使用MACHINE_POWER_POLICY結構來設定電源原則之前,先呼叫 GetCurrentPowerPolicies 或 ReadPwrScheme來 設定此值。
MinSleepAc
在 AC 電源上執行時,在系統睡眠動作上輸入的最低 Sx 值) (最低 Sx 值。 這個成員必須是其中一個 SYSTEM_POWER_STATE 列舉型別值。
MinSleepDc
最低系統電源狀態 (最低 Sx 值) ,以在電池電源上執行時,於系統睡眠動作上輸入。 這個成員必須是其中一個 SYSTEM_POWER_STATE 列舉型別值。
ReducedLatencySleepAc
系統電源狀態上限 (最高 Sx 值,) 在 AC 電源上執行時,以及在有未完成的延遲需求時,在系統睡眠動作上輸入。 這個成員必須是其中一個 SYSTEM_POWER_STATE 列舉型別值。 如果應用程式使用 LT_LOWEST_LATENCY 呼叫 RequestWakeupLatency,則使用 ReducedLatencySleepAc 取代 MaxSleepAc。
ReducedLatencySleepDc
系統電源狀態上限 (最高 Sx 值) ,以在電池電源上執行時,以及在有未完成的延遲需求時,於系統睡眠動作上輸入。 這個成員必須是其中一個 SYSTEM_POWER_STATE 列舉型別值。 如果應用程式使用 LT_LOWEST_LATENCY 呼叫 RequestWakeupLatency,則使用 ReducedLatencySleepAc 取代 MaxSleepAc。
DozeTimeoutAc
忽略此成員。
DozeTimeoutDc
忽略此成員。
DozeS4TimeoutAc
當系統在 AC 電源上執行時,在進入暫停狀態和進入休眠睡眠狀態之間等待的時間,以秒為單位。 值為零表示永不休眠。
DozeS4TimeoutDc
當系統在電池電力上執行時,在進入暫停狀態和進入休眠睡眠狀態之間等待的時間,以秒為單位。 值為零表示永不休眠。
MinThrottleAc
系統在 AC 電源上執行之前允許的最小節流設定。 熱條件是低於最小設定的唯一原因。 當處理器被過度存取時,系統會起始 OverThrottledAc 原則 。 請注意,每當任何熱區域指出重大熱狀況時,電源原則管理員都有硬式編碼的原則來起始 CriticalShutdownOff。 範圍:0-100。
MinThrottleDc
當系統在電池電力上執行時,允許的最小節流設定會先被過度限制。 熱條件是低於最小設定的唯一原因。 當處理器被過度存取時,系統會起始 OverThrottledDc 原則。 請注意,每當任何熱區域指出重大熱狀況時,電源原則管理員都有硬式編碼的原則來起始 CriticalShutdownOff。 範圍:0-100。
pad1[2]
保留的。
OverThrottledAc
POWER_ACTION_POLICY結構,定義當處理器在 AC 電源上執行時,由 MinThrottleAc 成員所定義 (所定義的動作) 。
OverThrottledDc
POWER_ACTION_POLICY結構,定義當處理器在電池電源上執行時,由 MinThrottleDc 成員) 所定義的 (所要採取的動作。
備註
DozeS4TimeoutAc 和 DozeS4TimeoutDc 會對應至SYSTEM_POWER_POLICY的 DozeS4Timeout 成員。 呼叫 SetActivePwrScheme 函式以套用電源配置時,這些值會從機器電源原則合併到系統電源原則。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限桌面應用程式] |
標頭 | powrprof.h |