IOCTL_BATTERY_GETSYSTEMPOWERSTATUSEX (Windows Embedded CE 6.0)

1/6/2010

This IOCTL retrieves information for the GetSystemPowerStatusEx system call. 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_GETSYSTEMPOWERSTATUSEX.

• pInBuf
  [in] Pointer to a BOOL, fUpdate.

• InBufLen
  [in] Set to sizeof(BOOL).

• pOutBuf
  [out] Pointer to a SYSTEM_POWER_STATUS_EX structure.

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

• 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(SYSTEM_POWER_STATUS_EX). Otherwise, DeviceIoControl returns FALSE. In case of failure, GetLastError contains an error status.

Remarks

If fUpdate is set to TRUE, this IOCTL gets the latest information from the battery PDD, otherwise it retrieves cached information that may be out-of-date by several seconds.

For more information, see GetSystemPowerStatusEx and BatteryPDDGetStatus.

Requirements

See Also

Reference

BatteryPDDGetStatus
DeviceIoControl

Concepts

Battery Driver IOCTLs

Other Resources

GetSystemPowerStatusEx
SYSTEM_POWER_STATUS_EX