ISensOnNow::BatteryLow method (sensevts.h)
The BatteryLow method notifies an application that battery power is low. SENS calls the BatteryLow method to notify an application that a computer is using battery power.
Low battery power is signaled when a system is on battery power and the battery is low according to the same logic used by the Advanced Power Management (APM) event PBT_APMBATTERYLOW. This event is broadcast when a system APM BIOS sends an APM battery low notification.
Some APM BIOS implementations do not provide notifications when batteries are low, which means that this event may never be broadcast on some computers.
Syntax
HRESULT BatteryLow(
[in] DWORD dwBatteryLifePercent
);
Parameters
[in] dwBatteryLifePercent
The percent of battery power that remains.
Return value
This method can return one of these values.
| Return code | Description |
|---|---|
|
The method returns successfully. |
Remarks
SENS calls this method to notify an application that a computer is using battery power. The remaining percentage of battery power is specified.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows XP [desktop apps only] |
| Minimum supported server | Windows Server 2003 [desktop apps only] |
| Target Platform | Windows |
| Header | sensevts.h |
| DLL | Sens.dll |
See also
About System Event Notification Service