Freigeben über


BATTERY_REPORTING_SCALE-Struktur (winnt.h)

Enthält die Granularität der Akkukapazität, die von IOCTL_BATTERY_QUERY_STATUS gemeldet wird. Ein Array mit BATTERY_REPORTING_SCALE Strukturen mit variabler Länge wird von IOCTL_BATTERY_QUERY_INFORMATION zurückgegeben, wenn InformationLevel auf BatteryGranularityInformation festgelegt ist. Mehrere Einträge werden zurückgegeben, wenn die Granularität von der aktuellen Kapazität des Akkus abhängt.

Syntax

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

Member

Granularity

Die Granularität des von IOCTL_BATTERY_QUERY_STATUS zurückgegebenen Kapazitätslesewerts in Milliwattstunden (mWh). Die Granularität kann sich im Laufe der Zeit ändern, wenn die Akkuentladung und das Aufladen den Messbereich verringert.

Capacity

Die obere Kapazitätsgrenze für die Granularität. Der Wert der Granularität gilt für von IOCTL_BATTERY_QUERY_STATUS gemeldete Kapazitäten, die kleiner oder gleich dieser Kapazität (mWh), aber größer oder gleich der im vorherigen Arrayelement angegebenen Kapazität sind, oder null, wenn es sich um das erste Arrayelement handelt.

Hinweise

Die Gesamtzahl der von IOCTL_BATTERY_QUERY_INFORMATION zurückgegebenen BATTERY_REPORTING_SCALE Einträge wird durch den Wert des lpBytesReturned-Parameters von DeviceIoControl angegeben. Um die Anzahl der Elemente im Array zu bestimmen, dividieren Sie den Wert von lpBytesReturned durch die Größe der BATTERY_REPORTING_SCALE-Struktur . Die maximale Anzahl von Arrayeinträgen, die zurückgegeben werden können, beträgt vier.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Kopfzeile winnt.h (windows.h einschließen)

Weitere Informationen

IOCTL_BATTERY_QUERY_INFORMATION

IOCTL_BATTERY_QUERY_STATUS