次の方法で共有


IOCTL_BATTERY_GETLEVELS (Windows CE 5.0)

Send Feedback

This IOCTL returns the number of levels that the battery driver is capable of returning in the BatteryFlag and BackupBatteryFlag members of the SYSTEM_POWER_STATUS_EX2 structure. 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_GETLEVELS.
  • pInBuf
    [in] Set to NULL.
  • InBufLen
    [in] Set to zero.
  • pOutBuf
    [out] Pointer to a LONG that will be filled in with battery level information.
  • OutBufLen
    [in] Set to sizeof(LONG).
  • 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(LONG). Otherwise, DeviceIoControl returns FALSE. In case of failure, GetLastError contains an error status.

Remarks

For more information about the data returned by this IOCTL, see BatteryPDDGetLevels and BatteryDrvrGetLevels.

Requirements

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

See Also

BatteryDrvrGetLevels | BatteryPDDGetLevels | CreateFile | DeviceIoControl | SYSTEM_POWER_STATUS_EX2

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.