PowerSetRequest 函式 (winbase.h)

遞增電源要求物件指定類型的電源要求計數。

語法

BOOL PowerSetRequest(
  [in] HANDLE             PowerRequest,
  [in] POWER_REQUEST_TYPE RequestType
);

[in] PowerRequest

電源要求物件的控制碼。

[in] RequestType

要遞增的電源要求類型。此參數可以是下列其中一個值。

值	描述
PowerRequestDisplayRequired	即使沒有使用者輸入一段時間，顯示器仍會保持開啟狀態。注意：除了PowerRequestDisplayRequired之外，還必須採取PowerRequestSystemRequired，以確保顯示器在要求期間不會進入睡眠狀態。
PowerRequestSystemRequired	系統會在使用者閒置期間後繼續執行，而不是進入睡眠狀態。
PowerRequestAwayModeRequired	系統會進入離開模式，而不是睡眠，以回應使用者的明確動作。在離開模式中，系統會繼續執行，但關閉音訊和視訊，以提供睡眠的外觀。 PowerRequestAwayModeRequired 僅適用于傳統睡眠 (S3) 系統。
PowerRequestExecutionRequired	呼叫進程會繼續執行，而不是由進程存留期管理機制暫停或終止。允許進程執行的時間和時間取決於作業系統和電源原則設定。在傳統睡眠 (S3) 系統上，作用中的 PowerRequestExecutionRequired 要求表示 PowerRequestSystemRequired。

如果函式成功，它會傳回非零值。

如果函式失敗，它會傳回零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

在 DC 電源的新式待命系統上，系統和執行所需的電源要求會在系統睡眠逾時過期之後 5 分鐘終止。

除了傳統睡眠 (S3) 系統上的 PowerRequestAwayModeRequired之外，電源要求會在使用者起始的系統睡眠輸入 (電源按鈕終止，從 [開始] 功能表) 關閉或選取 [睡眠]。

為了節省電源並提供最佳的使用者體驗，使用電源要求的應用程式應遵循下列最佳做法：