共用方式為


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結構來設定電源原則之前,先呼叫 GetCurrentPowerPoliciesReadPwrScheme 設定此值。

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 成員) 所定義的 (所要採取的動作。

備註

DozeS4TimeoutAcDozeS4TimeoutDc 會對應至SYSTEM_POWER_POLICYDozeS4Timeout 成員。 呼叫 SetActivePwrScheme 函式以套用電源配置時,這些值會從機器電源原則合併到系統電源原則。

規格需求

需求
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
標頭 powrprof.h

另請參閱

POWER_ACTION_POLICY

POWER_POLICY