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

power-event 通知。 このパラメーターには、次の値のいずれかを指定できます。

説明
PWR_CRITICALRESUME
最初に PWR_SUSPENDREQUEST通知メッセージ をアプリケーションにブロードキャストせずに、中断モードに入った後にシステムが操作を再開することを示します。 アプリケーションは、必要な回復アクションを実行する必要があります。
PWR_SUSPENDREQUEST
システムが中断モードに入りようとしていることを示します。
PWR_SUSPENDRESUME
システムが通常は中断モードに入った後に操作を再開していることを示します。つまり、システムは、システムが中断される前に 、PWR_SUSPENDREQUEST 通知メッセージをアプリケーションにブロードキャストします。 アプリケーションは、必要な回復アクションを実行する必要があります。

lParam

このパラメーターは使用されません。

戻り値

アプリケーションが返す値は、 wParam パラメーターの値によって異なります。 wParamPWR_SUSPENDREQUEST場合、システムが中断状態にならないように戻り値がPWR_FAILされます。それ以外の場合は、PWR_OKwParamPWR_SUSPENDRESUMEまたはPWR_CRITICALRESUMEの場合、戻り値は 0 になります。

注釈

このメッセージは、Advanced Power Management (APM) の基本的な入出力システム (BIOS) 仕様に準拠しているシステムで実行されているアプリケーションにのみブロードキャストされます。 このメッセージは、電源管理ドライバーによって 、EnumWindows 関数によって返される各ウィンドウにブロードキャストされます。

中断モードは、最大の電力節約が発生した状態ですが、すべての運用データとパラメーターが保持されます。 ランダム アクセス メモリ (RAM) の内容は保持されますが、多くのデバイスがオフになる可能性があります。

要件

要件
サポートされている最小のクライアント
Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー
Windows Server 2003 [デスクトップ アプリのみ]
Header
WinUser.h (Windows.h を含む)

こちらもご覧ください

WM_POWERBROADCAST