BATTERY_STATUS 구조체

배터리의 현재 상태를 포함합니다. 이 구조체는 IOCTL_BATTERY_QUERY_STATUS 제어 코드에서 사용됩니다.

구문

typedef struct _BATTERY_STATUS {
  ULONG PowerState;
  ULONG Capacity;
  ULONG Voltage;
  LONG  Rate;
} BATTERY_STATUS, *PBATTERY_STATUS;

멤버

PowerState

배터리 상태입니다. 이 멤버는 다음 값 중 0개, 1개 이상일 수 있습니다.

값	의미
BATTERY_CHARGING 0x00000004	배터리가 현재 충전 중임을 나타냅니다.
BATTERY_CRITICAL 0x00000008	배터리 오류가 임박했음을 나타냅니다. 자세한 내용은 설명 부분을 참조하세요.
BATTERY_DISCHARGING 0x00000002	배터리가 현재 방전 중임을 나타냅니다.
BATTERY_POWER_ON_LINE 0x00000001	시스템에서 AC 전원에 액세스할 수 있으므로 배터리가 방전되지 않음을 나타냅니다.

용량

현재 배터리 용량(mWh 또는 상대)입니다. 이 값은 BATTERY_INFORMATION 구조체의 FullChargedCapacity 멤버로 나누어 "가스 계기" 디스플레이를 생성하는 데 사용할 수 있습니다. 용량을 사용할 수 없는 경우 이 멤버는 BATTERY_UNKNOWN_CAPACITY.

전압

배터리 터미널의 현재 배터리 전압(밀리볼트)입니다. 전압을 사용할 수 없는 경우 이 멤버가 BATTERY_UNKNOWN_VOLTAGE.

비용

배터리 충전 또는 방전의 현재 속도입니다. 이 값은 배터리 속도 정보가 상대적인 경우가 아니면 밀리와트 단위입니다. 이 경우 시간당 임의의 단위로 표시됩니다. 배터리 정보가 상대적인지 확인하려면 BATTERY_INFORMATION 구조의 Capabilities 멤버에서 BATTERY_CAPACITY_RELATIVE 플래그를 검사합니다. 0이 아닌 양수 비율은 충전을 나타냅니다. 음수 비율은 방전을 나타냅니다. 일부 배터리는 방전 속도만 보고합니다. 속도를 사용할 수 없는 경우 이 멤버는 BATTERY_UNKNOWN_RATE. 배터리 또는 전원 상태가 변경되면 속도를 사용할 수 있습니다.

설명

이 구조체의 PowerState 멤버에 있는 BATTERY_CRITICAL 플래그는 하드웨어 "배터리 위험" 상태를 나타냅니다. 이 중요 수준은 "중요한 배터리 경보"의 사용자가 아닌 배터리 제조업체에 의해 설정됩니다. 일반적으로 배터리 시스템이 배터리가 완전히 소모되고 모든 전력이 예상한 것 이상으로 계산되었음을 의미합니다.

요구 사항

추가 정보

BATTERY_INFORMATION

IOCTL_BATTERY_QUERY_STATUS