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

wParam

電源管理イベント。 このパラメータには、次のいずれかのイベント識別子を指定できます。

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

要件

関連項目

• WM_POWERBROADCAST メッセージ
• Power Management メッセージ
• RegisterSuspendResumeNotification