Share via


BatteryGetLifeTimeInfo (Windows Embedded CE 6.0)

1/6/2010

This function retrieves the time the user changed the batteries, the amount of time they used the batteries, and the amount of time they used the batteries before replacing them.

Syntax

void BatteryGetLifeTimeInfo( 
  LPSYSTEMTIME pstLastChange, 
  DWORD* pcmsCpuUsage, 
  DWORD* pcmsPreviousCpuUsage 
);

Parameters

  • pstLastChange
    [out] Pointer to the local time when the user last changed the batteries.
  • pcmsCpuUsage
    [out] Pointer to the number of milliseconds that the current batteries have been in active use.
  • pcmsPreviousCpuUsage
    [out] Pointer to the number of milliseconds that the previous batteries were in active use before the user replaced them, or zero if unknown.

Return Value

None.

Remarks

To use this function, your operating system must have a battery driver. This function only returns useful information if BatteryDrvrSupportsChangeNotification returns TRUE.

Requirements

Header pwinuser.h
Library coredll.lib
Windows Embedded CE Windows CE 2.10 and later

See Also

Reference

BatteryPDDGetStatus
BatteryDrvrSupportsChangeNotification

Concepts

Battery Driver Functions

Other Resources

SYSTEMTIME