Compartir a través de


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

El método BatteryLow notifica a una aplicación que la energía de la batería es baja. SENS llama al método BatteryLow para notificar a una aplicación que un equipo está usando energía de batería.

La baja potencia de la batería se señala cuando un sistema está en la energía de la batería y la batería es baja según la misma lógica utilizada por el evento de administración avanzada de energía (APM) PBT_APMBATTERYLOW. Este evento se transmite cuando un BIOS de APM del sistema envía una notificación de batería baja de APM.

Algunas implementaciones del BIOS de APM no proporcionan notificaciones cuando las baterías son bajas, lo que significa que este evento nunca se puede difundir en algunos equipos.

Sintaxis

HRESULT BatteryLow(
  [in] DWORD dwBatteryLifePercent
);

Parámetros

[in] dwBatteryLifePercent

El porcentaje de energía de la batería que permanece.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto Descripción
S_OK
El método devuelve correctamente.

Comentarios

SENS llama a este método para notificar a una aplicación que un equipo está usando la energía de la batería. Se especifica el porcentaje restante de energía de la batería.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado sensevts.h
Archivo DLL Sens.dll

Consulte también

Acerca del servicio de notificación de eventos del sistema

IEventSubscription

IEventSubscription::P utPublisherProperty

ISensOnNow

ISensOnNow::OnBatteryPower