SYSTEM_BATTERY_STATE 구조체(winnt.h)

시스템 배터리의 현재 상태에 대한 정보를 포함합니다.

구문

typedef struct {
  BOOLEAN AcOnLine;
  BOOLEAN BatteryPresent;
  BOOLEAN Charging;
  BOOLEAN Discharging;
  BOOLEAN Spare1[3];
  BYTE    Tag;
  DWORD   MaxCapacity;
  DWORD   RemainingCapacity;
  DWORD   Rate;
  DWORD   EstimatedTime;
  DWORD   DefaultAlert1;
  DWORD   DefaultAlert2;
} SYSTEM_BATTERY_STATE, *PSYSTEM_BATTERY_STATE;

멤버

AcOnLine

이 멤버가 TRUE이면 시스템 배터리 충전기가 현재 외부 전원에서 작동합니다.

BatteryPresent

이 멤버가 TRUE이면 시스템에 하나 이상의 배터리가 있습니다.

Charging

이 멤버가 TRUE이면 배터리가 현재 충전 중입니다.

Discharging

이 멤버가 TRUE이면 배터리가 현재 방전되고 있습니다.

Spare1[3]

예약되어 있습니다.

Tag

MaxCapacity

새 배터리의 이론적 용량입니다.

RemainingCapacity

배터리의 예상 남은 용량입니다.

Rate

배터리의 현재 방전 속도(mW)입니다. 0이 아닌 양수 비율은 충전을 나타냅니다. 음수 비율은 방전을 나타냅니다. 일부 배터리는 방전 속도만 보고합니다. 이 값은 음수 값(높은 비트 집합 포함)을 포함할 수 있으므로 LONG 으로 처리해야 합니다.

EstimatedTime

배터리에 남아 있는 예상 시간(초)입니다.

DefaultAlert1

배터리 부족 경고가 발생해야 하는 용량(mWh)에 대한 제조업체의 제안입니다. 낮은 정의는 제조업체마다 다릅니다. 일반적으로 경고 상태는 낮은 상태 이전에 발생하지만 항상 그렇게 가정해서는 안 됩니다. 데이터 손실 위험을 줄이기 위해 이 값은 일반적으로 중요한 배터리 경보의 기본 설정으로 사용됩니다.

DefaultAlert2

제조업체의 용량 제안(mWh)으로, 경고 배터리 경고가 발생해야 합니다. 경고 정의는 제조업체마다 다릅니다. 일반적으로 경고 상태는 낮은 상태 이전에 발생하지만 항상 그렇게 가정해서는 안 됩니다. 데이터 손실 위험을 줄이기 위해 이 값은 일반적으로 배터리 부족 경보의 기본 설정으로 사용됩니다.

요구 사항

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

추가 정보

CallNtPowerInformation