共用方式為

WM_POWERBROADCAST訊息

  • 發行項

通知應用程式電源管理事件已發生。

視窗會透過其 WindowProc 函式接收此訊息。

LRESULT CALLBACK WindowProc(
  HWND   hwnd,    // handle to window
  UINT   uMsg,    // WM_POWERBROADCAST
  WPARAM wParam,  // power-management event
  LPARAM lParam   // function-specific data
);

參數

hwnd

視窗的句柄。

uMsg

值 意義
WM_POWERBROADCAST
536 （0x218）
 訊息標識碼。

wParam

電源管理事件。 此參數可以是下列其中一個事件標識碼。

Event 意義
PBT_APMPOWERSTATUSCHANGE
10 （0xA）
 電源狀態已變更。
PBT_APMRESUMEAUTOMATIC
18 （0x12）
 作業會自動從低功率狀態繼續。 每次系統繼續時，都會傳送此訊息。
PBT_APMRESUMESUSPEND
7 （0x7）
 作業會從低功率狀態繼續執行。 如果繼續是由使用者輸入觸發，例如按下按鍵，則會在PBT_APMRESUMEAUTOMATIC之後傳送此訊息。
PBT_APMSUSPEND
4 （0x4）
 系統正在暫停作業。
PBT_POWERSETTINGCHANGE
32787 （0x8013）
 已收到電源設定變更事件。

lParam

事件特定的數據。 對於大部分的事件，此參數是保留的，不會使用。

如果 wParam 參數是PBT_POWERSETTINGCHANGE，則 lParam 參數是POWERBROADCAST_SETTING結構的指標。

傳回值

如果應用程式處理此訊息，應用程式應該會傳回 TRUE 。

備註

每當系統繼續時，系統一 律會傳送PBT_APMRESUMEAUTOMATIC 訊息。 如果系統繼續回應使用者輸入，例如按下按鍵，系統也會在傳送PBT_APMRESUMEAUTOMATIC之後傳送 PBT_APMRESUMESUSPEND 訊息。

WM_POWERBROADCAST訊息不會區分不同的低功率狀態。 應用程式只能判斷系統正在進入或已從低功率狀態繼續;它無法判斷特定的電源狀態。 系統會記錄 Windows 系統事件記錄檔中電源狀態轉換的詳細數據。

若要防止系統在 Windows Vista 中轉換為低功率狀態，應用程式必須呼叫 SetThreadExecutionState ，通知系統正在使用中。

需求一節中指定的任何操作系統都不支援下列訊息：

  • PBT_APMQUERYSTANDBY
  • PBT_APMQUERYSTANDBYFAILED
  • PBT_APMSTANDBY
  • PBT_APMRESUMESTANDBY

需求

需求 值
最低支援的用戶端
 Windows XP [僅限傳統型應用程式]
最低支援的伺服器
 Windows Server 2003 [僅限傳統型應用程式]
頁首
WinUser.h （包括 Windows.h）

另請參閱