Partager via

IOCTL_BATTERY_GETSYSTEMPOWERSTATUSEX2

  • Article

This IOCTL retrieves information for the GetSystemPowerStatusEx2 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_GETSYSTEMPOWERSTATUSEX2.
  • pInBuf
    [in] Pointer to a BOOL, fUpdate.
  • InBufLen
    [in] Set to sizeof(BOOL).
  • pOutBuf
    [out] Pointer to a SYSTEM_POWER_STATUS_EX2 structure.
  • OutBufLen
    [in] Size of the structure pointed to by pOutBuf, in bytes.
  • 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_EX2). 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 GetSystemPowerStatusEx2 and BatteryPDDGetStatus.

Requirements

OS Versions: Windows CE .NET 4.2 and later.
Header: Battery.h.

See Also

Battery Drivers | BatteryPDDGetStatus | DeviceIoControl | GetSystemPowerStatusEx2 | SYSTEM_POWER_STATUS_EX2

 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.