Edit

BATTERY_REPORTING_SCALE structure (winnt.h)

  • Article

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 {
  DWORD Granularity;
  DWORD 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

Requirement Value
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