estructura de BATTERY_STATUS
Contiene el estado actual de la batería. El código de control de IOCTL_BATTERY_QUERY_STATUS usa esta estructura.
Sintaxis
typedef struct _BATTERY_STATUS {
ULONG PowerState;
ULONG Capacity;
ULONG Voltage;
LONG Rate;
} BATTERY_STATUS, *PBATTERY_STATUS;
Miembros
-
PowerState
-
Estado de la batería. Este miembro puede ser cero, uno o varios de los valores siguientes.
Valor Significado - BATTERY_CHARGING
- 0x00000004
Indica que la batería está cargando actualmente. - BATTERY_CRITICAL
- 0x00000008
Indica que el error de batería es inminente. Vea la sección Comentarios para obtener más información. - BATTERY_DISCHARGING
- 0x00000002
Indica que la batería se está descargando actualmente. - BATTERY_POWER_ON_LINE
- 0x00000001
Indica que el sistema tiene acceso a la alimentación de CA, por lo que no se descargan baterías. -
Capacity
-
Capacidad de la batería actual, en mWh (o relativa). Este valor se puede usar para generar una presentación de "medidor de gas" dividiéndola por el miembro FullChargedCapacity de la estructura BATTERY_INFORMATION . Si la capacidad no está disponible, este miembro se BATTERY_UNKNOWN_CAPACITY.
-
Voltage (Voltaje)
-
El voltaje de la batería actual en los terminales de batería, en milivolts (mv). Si el voltaje no está disponible, este miembro es BATTERY_UNKNOWN_VOLTAGE.
-
Tarifa
-
Velocidad actual de carga o descarga de la batería. Este valor estará en miliwatts a menos que la información de velocidad de la batería sea relativa, en cuyo caso estará en unidades arbitrarias por hora. Para determinar si la información de la batería es relativa, examine la marca BATTERY_CAPACITY_RELATIVE en el miembro Capabilities de la estructura BATTERY_INFORMATION . Una tasa positiva distinta de cero indica la carga; una tasa negativa indica la descarga. Algunas baterías solo notifican tasas de descarga. Si la tarifa no está disponible, este miembro se BATTERY_UNKNOWN_RATE. Si cambia el estado de la batería o de la fuente de alimentación, la velocidad puede estar disponible.
Comentarios
La marca BATTERY_CRITICAL del miembro PowerState de esta estructura indica una condición de hardware "crítica para la batería". Este nivel crítico lo establece el fabricante de la batería, no el usuario en la "alarma crítica de la batería". Por lo general, significa que el sistema de baterías ha calculado que la batería está totalmente purgada, y cualquier potencia que se dibuja es más allá de lo esperado.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
Windows Server 2003 [solo aplicaciones de escritorio] |
| Encabezado |
|