다음을 통해 공유

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

예약; 은 0이어야 합니다.

반환 값

반환 값이 없습니다.

설명

애플리케이션은 GetSystemPowerStatus 함수를 호출하여 컴퓨터의 현재 전원 상태 검색하여 이 이벤트를 처리해야 합니다. 특히 애플리케이션은 변경 내용에 대해 SYSTEM_POWER_STATUS 구조의 ACLineStatus, BatteryFlag, BatteryLifeTime 및 BatteryLifePercent 멤버를 검사 합니다. 이 이벤트는 배터리 수명이 5분 미만으로 떨어지거나 배터리 수명이 10% 미만으로 떨어지거나 배터리 수명이 3% 변경되는 경우에 발생할 수 있습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버
 Windows Server 2003[데스크톱 앱만 해당]
헤더
WinUser.h(Windows.h 포함)

참고 항목