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

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

イベント 説明
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 [デスクトップ アプリのみ]
Header
WinUser.h (Windows.h を含む)

こちらもご覧ください

WM_POWERBROADCAST メッセージ

Power Management メッセージ