PBT_APMPOWERSTATUSCHANGE 事件

  • 發行項

通知應用程式電腦電源狀態的變更，例如從電池電源切換到 A/C。 當剩餘的電池電源低於使用者指定的臨界值，或電池計量變更百分比時，系統也會廣播此事件。

視窗會透過 WM_POWERBROADCAST 訊息接收此事件。 wParam 和 lParam 參數會設定如下所述。

LRESULT 
CALLBACK 
WindowProc( HWND hwnd,      // handle to window
            UINT uMsg,      // WM_POWERBROADCAST
            WPARAM wParam,  // PBT_APMPOWERSTATUSCHANGE
            LPARAM lParam); // zero

參數

hwnd

視窗的控制碼。

uMsg

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

wParam

值 意義
PBT_APMPOWERSTATUSCHANGE
10 （0xA）
 事件識別碼。

lParam

保留;必須是零。

傳回值

沒有傳回值。

備註

應用程式應該呼叫 GetSystemPowerStatus 函式以擷取電腦的目前電源狀態來處理此事件。 特別是，應用程式應該檢查 ACLineStatus、BatteryFlag 、 BatteryLifeTime 和 BatteryLifePercent 成員SYSTEM_POWER_STATUS 結構是否有任何變更。 當電池使用時間下降到不到 5 分鐘，或電池使用時間百分比低於 10%， 或電池使用時間變更 3% 時，就會發生此事件。

需求

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

另請參閱