estructura SYSTEM_BATTERY_STATE (winnt.h)

Contiene información sobre el estado actual de la batería del sistema.

Sintaxis

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;

Members

AcOnLine

Si este miembro es TRUE, el cargador de batería del sistema funciona actualmente en energía externa.

BatteryPresent

Si este miembro es TRUE, al menos una batería está presente en el sistema.

Charging

Si este miembro es TRUE, una batería se está cargando actualmente.

Discharging

Si este miembro es TRUE, actualmente se está descargando una batería.

Spare1[3]

Reservado.

Tag

MaxCapacity

La capacidad teórica de la batería cuando es nueva.

RemainingCapacity

Capacidad restante estimada de la batería.

Rate

Velocidad actual de descarga de la batería, en mW. Una tasa positiva distinta de cero indica la carga; una tasa negativa indica la descarga. Algunas baterías solo notifican tasas de descarga. Este valor se debe tratar como LONG , ya que puede contener valores negativos (con el conjunto de bits alto).

EstimatedTime

Tiempo estimado restante en la batería, en segundos.

DefaultAlert1

La sugerencia del fabricante de una capacidad, en mWh, en la que debe producirse una alerta de batería baja. Las definiciones de bajo varían de fabricante a fabricante. En general, se producirá un estado de advertencia antes de un estado bajo, pero no debe suponer que siempre lo hará. Para reducir el riesgo de pérdida de datos, este valor se suele usar como configuración predeterminada para la alarma crítica de la batería.

DefaultAlert2

La sugerencia del fabricante de una capacidad, en mWh, en la que debe producirse una alerta de advertencia de batería. Las definiciones de advertencia varían de fabricante a fabricante. En general, se producirá un estado de advertencia antes de un estado bajo, pero no debe suponer que siempre lo hará. Para reducir el riesgo de pérdida de datos, este valor se suele usar como configuración predeterminada para la alarma de batería baja.

Requisitos

Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado	winnt.h (incluye Windows.h)

Consulte también

CallNtPowerInformation