WM_POWER訊息
通知應用程式系統通常是電池式個人電腦,即將進入暫停模式。
注意
WM_POWER訊息已過時。 它僅供與 16 位 Windows 應用程式相容。 應用程式應該使用 WM_POWERBROADCAST 訊息。
視窗會透過 其 WindowProc 函 式接收此訊息。
LRESULT CALLBACK WindowProc
HWND hwnd, // handle to window
UINT uMsg, // WM_POWER
WPARAM wParam, // power-event notification
LPARAM lParam // not used
);
參數
-
hwnd
-
視窗的控制碼。
-
uMsg
-
訊息識別碼WM_POWER。
-
wParam
-
電源事件通知。 此參數可以是下列其中一個值。
值 意義 - PWR_CRITICALRESUME
表示系統在進入暫停模式後繼續作業,而不需要先將 PWR_SUSPENDREQUEST 通知訊息廣播到應用程式。 應用程式應該執行任何必要的復原動作。 - PWR_SUSPENDREQUEST
表示系統即將進入暫停模式。 - PWR_SUSPENDRESUME
表示系統在正常進入暫停模式之後繼續作業,也就是說,系統會在系統暫停之前,將 PWR_SUSPENDREQUEST 通知訊息廣播至應用程式。 應用程式應該執行任何必要的復原動作。 -
lParam
-
不使用這個參數。
傳回值
應用程式傳回的值取決於 wParam 參數的值。 如果 wParamPWR_SUSPENDREQUEST,則會 PWR_FAIL 傳回值,以防止系統進入暫停狀態;否則會 PWR_OK。 如果 wParam是PWR_SUSPENDRESUME 或 PWR_CRITICALRESUME,則傳回值為零。
備註
此訊息只會廣播至符合進階電源管理 (APM) 基本輸入/輸出系統的應用程式, (BIOS) 規格。 訊息會由電源管理驅動程式廣播至 EnumWindows 函式所傳回的每個視窗。
暫停模式是發生最大電源節省量的狀態,但會保留所有運算元據和參數。 會保留隨機存取記憶體 (RAM) 內容,但可能會關閉許多裝置。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows XP [僅限傳統型應用程式] |
最低支援的伺服器 |
Windows Server 2003 [僅限桌面應用程式] |
標頭 |
|