estructura de BATTERY_INFORMATION
Contiene información de batería. El código de control IOCTL_BATTERY_QUERY_INFORMATION devuelve esta estructura cuando se solicita el nivel de información BatteryInformation.
Sintaxis
typedef struct _BATTERY_INFORMATION {
ULONG Capabilities;
UCHAR Technology;
UCHAR Reserved[3];
UCHAR Chemistry[4];
ULONG DesignedCapacity;
ULONG FullChargedCapacity;
ULONG DefaultAlert1;
ULONG DefaultAlert2;
ULONG CriticalBias;
ULONG CycleCount;
} BATTERY_INFORMATION, *PBATTERY_INFORMATION;
Miembros
-
Capabilities
-
Las capacidades de la batería. Este miembro puede ser uno o varios de los valores siguientes.
Valor Significado - BATTERY_CAPACITY_RELATIVE
- 0x40000000
Indica que la capacidad de la batería y la información de velocidad son relativas y no en unidades específicas. Si no se establece este bit, las unidades de informes son miliwatt-hours (mWh) para capacidad y miliwatts (mW) para la velocidad. Si se establece este bit, se pueden omitir todas las referencias a unidades de la otra documentación de batería. Toda la información de frecuencia se notifica en unidades por hora. Por ejemplo, si la capacidad totalmente cargada se notifica como 100, una tasa de 200 indica que la batería usará toda su capacidad en media hora. - BATTERY_IS_SHORT_TERM
- 0x20000000
Indica que la operación normal es para una función con seguridad por error. Si este bit no se establece, se espera que la batería se use durante el uso normal del sistema. - BATTERY_SET_CHARGE_SUPPORTED
- 0x00000001
Indica que este dispositivo de batería admite las solicitudes de información establecidas del tipo BatteryCharge. - BATTERY_SET_DISCHARGE_SUPPORTED
- 0x00000002
Indica que este dispositivo de batería admite las solicitudes de información establecidas del tipo BatteryDischarge. - BATTERY_SYSTEM_BATTERY
- 0x80000000
Indica que la batería puede proporcionar energía general para ejecutar el sistema. -
Technology
-
La tecnología de la batería. Este miembro puede ser uno de los valores siguientes.
Valor Significado - 0
Batería no recargable, por ejemplo, alcalina. - 1
Batería recargable, por ejemplo, ácido de plomo. -
Reserved
-
Reservado.
-
Química
-
Cadena de caracteres abreviada que indica la química de la batería. Esta cadena no termina necesariamente en cero. A continuación se muestra una lista parcial de abreviaturas que se pueden devolver y los químicos asociados.
Cadena de Unicode Significado - PbAc
Plomo - LEÓN
Ion de litio - Li-I
Ion de litio - Nicd
Níquel-cadmio - Nimh
Hidruro de metal de níquel - NiZn
Zinc de níquel - RAM
Alkaline-Manganese recargables Otros químicos pueden aparecer en el futuro y su código debe ser capaz de manejarlos.
-
DesignedCapacity
-
La capacidad teórica de la batería cuando es nueva, en mWh a menos que se establezca BATTERY_CAPACITY_RELATIVE. En ese caso, las unidades no están definidas.
-
FullChargedCapacity
-
La capacidad actual de la batería está totalmente cargada en mWh (o relativa). Compare este valor con DesignedCapacity para estimar el desgaste de la batería.
-
DefaultAlert1
-
La capacidad sugerida por el fabricante, 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 capacidad sugerida del fabricante, 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.
-
CriticalBias
-
Un sesgo de cero, en mWh, que se aplica a la generación de informes de batería. Algunas baterías reservan una pequeña carga sesgada de los valores de capacidad de la batería para mostrar "0" como el nivel de batería crítico. El sesgo crítico es análogo al establecimiento de un medidor de combustible para mostrar "vacío" cuando quedan varios litros de combustible.
-
CycleCount
-
El número de ciclos de carga/descarga que ha experimentado la batería. Esto proporciona un medio para determinar el desgaste de la batería. Si la batería no admite un contador de ciclo, este miembro es cero.
Comentarios
Por lo general, se produce un estado de advertencia antes de un estado bajo, pero no debe suponer que lo hará. Es posible sondear una batería y encontrar que no se ha producido ningún nivel de alerta, y sondear la batería de nuevo y encontrar la descarga en la medida en que se han logrado ambos niveles. Esto puede indicar que no está sondeando con frecuencia. También puede indicar que la batería no puede mantener una carga durante mucho tiempo y se descarga más rápidamente de lo esperado. Tal batería puede estar cerca del final de su vida útil, o puede dañarse.
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 |
|