SYSTEM_POWER_STATUS 구조체(winbase.h)

시스템의 전원 상태 대한 정보를 포함합니다.

구문

typedef struct _SYSTEM_POWER_STATUS {
  BYTE  ACLineStatus;
  BYTE  BatteryFlag;
  BYTE  BatteryLifePercent;
  BYTE  SystemStatusFlag;
  DWORD BatteryLifeTime;
  DWORD BatteryFullLifeTime;
} SYSTEM_POWER_STATUS, *LPSYSTEM_POWER_STATUS;

멤버

ACLineStatus

AC 전원 상태. 이 멤버는 다음 값 중 하나일 수 있습니다.

값	의미
0	오프라인
1	온라인
255	알 수 없음 상태

BatteryFlag

배터리 충전 상태. 이 멤버는 다음 플래그 중 하나 이상을 포함할 수 있습니다.

값	의미
1	높음 - 배터리 용량이 66% 이상입니다.
2	낮음 - 배터리 용량이 33% 미만입니다.
4	위험 - 배터리 용량이 5% 미만입니다.
8	Charging
128	시스템 배터리 없음
255	알 수 없는 상태 - 배터리 플래그 정보를 읽을 수 없음

 

배터리가 충전되지 않고 배터리 용량이 낮고 높으면 값이 0입니다.

BatteryLifePercent

남은 전체 배터리 충전의 백분율입니다. 이 멤버는 0에서 100까지의 값이거나 상태 알 수 없는 경우 255일 수 있습니다.

SystemStatusFlag

배터리 절약 모드의 상태. 에너지 절약에 참여하려면 배터리 절약 모드가 켜져 있을 때 리소스 집약적인 작업을 피하십시오. 이 값이 변경될 때 알림을 받으려면 전원 설정 GUID를 사용하여 RegisterPowerSettingNotification 함수를 GUID_POWER_SAVING_STATUS.

값	의미
0	배터리 절약 모드가 꺼져 있습니다.
1	배터리 절약 모드가 켜져 있습니다. 가능한 경우 에너지를 절약하세요.

 

참고 이 플래그와 GUID_POWER_SAVING_STATUS GUID는 Windows 10 도입되었습니다. 이 플래그는 이전에 Reserved1로 예약되었으며 값은 0입니다.

 

배터리 절약 모드에 대한 일반적인 내용은 배터리 절약 모드(하드웨어 구성 요소 지침)를 참조하세요.

BatteryLifeTime

남은 배터리 수명(초) 또는 남은 시간(초)을 알 수 없거나 디바이스가 AC 전원에 연결되어 있는 경우 –1입니다.

BatteryFullLifeTime

완전 충전 시 배터리 사용 시간(초) 또는 전체 배터리 수명을 알 수 없거나 디바이스가 AC 전원에 연결된 경우 –1입니다.

설명

이 시스템은 BatteryLifeTime 및 BatteryLifePercent에 대한 계산을 기반으로 BatteryFullLifeTime만 예측할 수 있습니다. 스마트 배터리 하위 시스템이 없으면 이 값이 유용할 만큼 정확하지 않을 수 있습니다.

요구 사항

지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
머리글	winbase.h(Windows.h 포함)

추가 정보

GetSystemPowerStatus

PBT_APMPOWERSTATUSCHANGE

배터리 절약 모드(하드웨어 구성 요소 지침)