Método ISensOnNow::BatteryLow (sensevts.h)

Artigo
03/01/2024

O método BatteryLow notifica um aplicativo de que a energia da bateria é baixa. O SENS chama o método BatteryLow para notificar um aplicativo de que um computador está usando energia da bateria.

A baixa energia da bateria é sinalizada quando um sistema está com energia da bateria e a bateria está fraca de acordo com a mesma lógica usada pelo evento APM (Gerenciamento Avançado de Energia) PBT_APMBATTERYLOW. Esse evento é transmitido quando um BIOS do APM do sistema envia uma notificação de bateria baixa do APM.

Algumas implementações do BIOS do APM não fornecem notificações quando as baterias estão baixas, o que significa que esse evento pode nunca ser transmitido em alguns computadores.

Sintaxe

HRESULT BatteryLow(
  [in] DWORD dwBatteryLifePercent
);

Parâmetros

[in] dwBatteryLifePercent

A porcentagem de energia da bateria que permanece.

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno	Descrição
S_OK	O método retorna com êxito.

Comentários

O SENS chama esse método para notificar um aplicativo de que um computador está usando energia da bateria. O percentual restante de energia da bateria é especificado.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	sensevts.h
DLL	Sens.dll