Freigeben über


ISensOnNow::BatteryLow-Methode (sensevts.h)

Die BatteryLow-Methode benachrichtigt eine Anwendung, dass die Akkuleistung niedrig ist. SENS ruft die BatteryLow-Methode auf, um eine Anwendung zu benachrichtigen, dass ein Computer Akkuleistung verwendet.

Eine niedrige Akkuleistung wird signalisiert, wenn sich ein System im Akkubetrieb befindet und der Akku gemäß derselben Logik niedrig ist, die auch vom APM-Ereignis (Advanced Power Management) PBT_APMBATTERYLOW verwendet wird. Dieses Ereignis wird übertragen, wenn ein System-APM-BIOS eine APM-Akku-Benachrichtigung sendet.

Einige APM-BIOS-Implementierungen bieten keine Benachrichtigungen, wenn die Akkus niedrig sind, was bedeutet, dass dieses Ereignis möglicherweise nie auf einigen Computern übertragen wird.

Syntax

HRESULT BatteryLow(
  [in] DWORD dwBatteryLifePercent
);

Parameter

[in] dwBatteryLifePercent

Der Prozentsatz der Akkuleistung, die übrig bleibt.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
Die -Methode gibt erfolgreich zurück.

Hinweise

SENS ruft diese Methode auf, um eine Anwendung zu benachrichtigen, dass ein Computer Akkuleistung verwendet. Der verbleibende Prozentsatz der Akkuleistung wird angegeben.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile sensevts.h
DLL Sens.dll

Weitere Informationen

Informationen zum Systemereignisbenachrichtigungsdienst

IEventSubscription

IEventSubscription::P utPublisherProperty

ISensOnNow

ISensOnNow::OnBatteryPower