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) |