閱讀英文

共用方式為


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_SUSPENDRESUMEPWR_CRITICALRESUME,則傳回值為零。

備註

此訊息只會廣播至符合進階電源管理 (APM) 基本輸入/輸出系統的應用程式, (BIOS) 規格。 訊息會由電源管理驅動程式廣播至 EnumWindows 函式所傳回的每個視窗。

暫停模式是發生最大電源節省量的狀態,但會保留所有運算元據和參數。 會保留隨機存取記憶體 (RAM) 內容,但可能會關閉許多裝置。

規格需求

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

另請參閱

WM_POWERBROADCAST