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[데스크톱 앱만 해당]
헤더
WinUser.h(Windows.h 포함)

참고 항목