USER_POWER_POLICY結構 (powrprof.h)
包含使用者每個電源配置唯一的電源原則設定。 這個結構是 POWER_POLICY 結構的一部分。
語法
typedef struct _USER_POWER_POLICY {
ULONG Revision;
POWER_ACTION_POLICY IdleAc;
POWER_ACTION_POLICY IdleDc;
ULONG IdleTimeoutAc;
ULONG IdleTimeoutDc;
UCHAR IdleSensitivityAc;
UCHAR IdleSensitivityDc;
UCHAR ThrottlePolicyAc;
UCHAR ThrottlePolicyDc;
SYSTEM_POWER_STATE MaxSleepAc;
SYSTEM_POWER_STATE MaxSleepDc;
ULONG Reserved[2];
ULONG VideoTimeoutAc;
ULONG VideoTimeoutDc;
ULONG SpindownTimeoutAc;
ULONG SpindownTimeoutDc;
BOOLEAN OptimizeForPowerAc;
BOOLEAN OptimizeForPowerDc;
UCHAR FanThrottleToleranceAc;
UCHAR FanThrottleToleranceDc;
UCHAR ForcedThrottleAc;
UCHAR ForcedThrottleDc;
} USER_POWER_POLICY, *PUSER_POWER_POLICY;
成員
Revision
目前的結構修訂層級。 使用USER_POWER_POLICY結構來設定電源原則之前，呼叫 GetCurrentPowerPolicies 或 ReadPwrScheme 來設定此值。
IdleAc
POWER_ACTION_POLICY 結構，定義系統在 AC (公用程式上執行時起始的系統電源動作，) 電源和系統閑置定時器到期。
IdleDc
POWER_ACTION_POLICY 結構，定義系統在電池電源上執行且系統閑置定時器到期時起始的系統電源動作。
IdleTimeoutAc
在AC (公用程式上執行時，系統閑置定時器在ac (公用) 程式上執行時，必須維持在閑置偵測閾值下方的時間，以秒為單位。
如果系統正在執行自動化繼續，因為沒有任何使用者存在，則會忽略此成員。 若要在應用程式執行工作時暫時讓系統保持執行狀態，請使用 SetThreadExecutionState 函式。
IdleTimeoutDc
系統活動層級必須低於閑置偵測閾值的時間，系統閑置定時器會在電池電源上執行時過期，以秒為單位。
如果系統正在執行自動化繼續，因為沒有任何使用者存在，則會忽略此成員。 若要在應用程式執行工作時暫時讓系統保持執行狀態，請使用 SetThreadExecutionState 函式。
IdleSensitivityAc
系統活動層級，定義系統在 AC (公用) 程式上執行時閒置偵測的臨界值，以百分比表示。
IdleSensitivityDc
當系統在電池電源上執行時，定義閑置偵測閾值的系統活動層級，以百分比表示。
ThrottlePolicyAc
當系統在 AC (公用程式上執行時，所要使用的處理器動態節流原則) 電源。
ThrottlePolicyDc
當系統在電池電源上執行時要使用的處理器動態節流原則。
MaxSleepAc
當系統在 AC (公用程式) 電源上執行時，系統睡眠狀態上限。 這個成員必須是其中一個 SYSTEM_POWER_STATE 列舉型別值。
MaxSleepDc
當系統在電池電源上執行時，系統睡眠狀態上限。 這個成員必須是其中一個 SYSTEM_POWER_STATE 列舉型別值。
Reserved[2]
保留的。
VideoTimeoutAc
當系統在 AC (公用) 程式上執行，以秒為單位的電源時，顯示器關閉之前的時間。
VideoTimeoutDc
當系統在電池電源上執行時，顯示器關閉之前的時間，以秒為單位。
SpindownTimeoutAc
當系統在 AC (公用程式) 電源時，電源到固定磁碟驅動器之前的時間會關閉。
SpindownTimeoutDc
當系統在電池電源上執行時，電源到固定磁碟驅動器之前的時間會關閉，以秒為單位。
OptimizeForPowerAc
如果此成員為 TRUE，系統將會開啟冷卻風扇，並在指定被動冷卻時以完整速度執行處理器，而且系統在 AC (公用程式上執行) 電源。 這會導致操作系統偏向使用風扇，並以完整速度執行處理器。
OptimizeForPowerDc
如果此成員為 TRUE，系統將會開啟冷卻風扇，並在指定被動冷卻且系統在電池電源上執行時，以完整速度執行處理器。 這會導致操作系統偏向使用風扇，並以完整速度執行處理器。
FanThrottleToleranceAc
當系統在 AC (公用) 程式上運作時，處理器在開啟系統風扇以回應熱事件之前，可能會將處理器節流到的下限，以百分比表示。
FanThrottleToleranceDc
在開啟系統風扇以百分比表示的系統電源運作時，處理器可能會在開啟系統風扇之前節流到的下限。
ForcedThrottleAc
當計算機在 AC (公用程式) 電源上執行時，系統所要加總的處理器節流層級，以百分比表示。
ForcedThrottleDc
當計算機在電池電源上執行時，系統要加總的處理器節流等級，以百分比表示。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
| 標頭 | powrprof.h |