IOCTL_BATTERY_GETLIFETIMEINFO (Windows Embedded CE 6.0)

1/6/2010

This IOCTL 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. The DeviceIoControl function calls this IOCTL.

Parameters

• hDevice
  [in] Handle to the device that is to perform the operation. To obtain a device handle, call the CreateFile function.

• dwIoControlCode
  [in] Set to IOCTL_BATTERY_GETLIFETIMEINFO.

• pInBuf
  [in] Set to NULL.

• InBufLen
  [in] Set to zero.

• pOutBuf
  [out] Pointer to a BATTERYLIFETIMEINFO structure.

• OutBufLen
  [in] Set to sizeof(BATTERYLIFETIMEINFO).

• lpBytesReturned
  [out] Long pointer to a variable that receives the size, in bytes, of the data stored into the buffer pointed to by lpOutBuffer.

• lpOverlapped
  [in] Ignored; set to NULL.

Return Values

If successful, DeviceIoControl returns TRUE and *pdwBytesTransferred will be sizeof(BATTERYLIFETIMEINFO). Otherwise, DeviceIoControl returns FALSE. In case of failure, GetLastError contains an error status.

Remarks

This IOCTL does not return meaningful data unless the battery driver supports change notification. For more information, see BatteryPDDSupportsChangeNotification and BatteryDrvrSupportsChangeNotification.

Requirements

See Also

Reference

BatteryDrvrSupportsChangeNotification
BATTERYLIFETIMEINFO
BatteryPDDSupportsChangeNotification
DeviceIoControl

Concepts

Battery Driver IOCTLs