EFI_BATTERY_CHARGING_PROTOCOL. ChargeBattery
Carga la batería principal en el nivel de destino especificado con una corriente de carga máxima.
Sintaxis
typedef EFI_STATUS (EFIAPI * EFI_BATTERY_CHARGING_CHARGE_BATTERY) (
IN EFI_BATTERY_CHARGING_PROTOCOL *This,
IN UINT32 MaximumCurrent,
IN UINT32 TargetStateOfCharge,
IN EFI_BATTERY_CHARGING_COMPLETION_TOKEN *CompletionToken );
Parámetros
Éste
[in] Puntero a la instancia de EFI_BATTERY_CHARGING_PROTOCOL.
MaximumCurrent
[in] Opcional. La corriente máxima en mA que se puede usar para cargar la batería principal. Un valor NULL solicita al controlador que implemente este protocolo para controlar estos detalles por sí mismos.
TargetStateOfCharge
[in] Estado de carga objetivo (SOC) de la batería principal después de la cual la función devolvería si CompletionToken es NULL. SOC se representa en porcentaje, 100% que indica el cargo completo.
CompletionToken
[in] Puntero a una EFI_BATTERY_CHARGING_COMPLETION_TOKEN asociada a la operación de cargo solicitada.
Valor devuelto
Devuelve uno de los siguientes códigos de estado.
status code | Descripción |
---|---|
EFI_SUCCESS | La función devolvió correctamente. |
EFI_INVALID_PARAMETER | Un parámetro era incorrecto. |
EFI_DEVICE_ERROR | El dispositivo físico notificó un error. |
EFI_NOT_READY | El dispositivo físico está ocupado o no está listo para procesar esta solicitud. |
Observaciones
Esta función sin bloqueo carga la batería principal en el nivel de destino especificado con una corriente de carga máxima.
Para detectar errores, el tipo de evento contenido en CompletionToken debe ser EVT_NOTIFY_SIGNAL, creado con CreateEventEx y debe asociar notifyFunction con CompletionToken como NotifyContext. El código de error de estado estará disponible a través del miembro Status de CompletionToken.
Requisitos
Rúbrica: Usuario generado