Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
BATTERY_REPORTING_SCALE

BATTERY_REPORTING_SCALE structure

Contains the granularity of the battery capacity that is reported by IOCTL_BATTERY_QUERY_STATUS. A variable-length array of BATTERY_REPORTING_SCALE structures is returned from IOCTL_BATTERY_QUERY_INFORMATION when the InformationLevel is set to BatteryGranularityInformation. Multiple entries are returned when the granularity depends on the present capacity of the battery.

Syntax


typedef struct {
  ULONG Granularity;
  ULONG Capacity;
} BATTERY_REPORTING_SCALE, *PBATTERY_REPORTING_SCALE;

Members

Granularity

The granularity of the capacity reading returned by IOCTL_BATTERY_QUERY_STATUS in milliwatt-hours (mWh). Granularity may change over time as battery discharge and recharge lowers the range of readings.

Capacity

The upper capacity limit for Granularity. The value of Granularity is valid for capacities reported by IOCTL_BATTERY_QUERY_STATUS that are less than or equal to this capacity (mWh), but greater than or equal to the capacity given in the previous array element, or zero if this is the first array element.

Remarks

The total number of BATTERY_REPORTING_SCALE entries returned from IOCTL_BATTERY_QUERY_INFORMATION is indicated by the value of the lpBytesReturned parameter of DeviceIoControl. To determine the number of elements in the array, divide the value of lpBytesReturned by the size of the BATTERY_REPORTING_SCALE structure. The maximum number of array entries that can be returned is four.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

WinNT.h (include Windows.h)

See also

IOCTL_BATTERY_QUERY_INFORMATION
IOCTL_BATTERY_QUERY_STATUS

 

 

Community Additions

ADD
Show:
© 2015 Microsoft