BATTERY_REPORTING_SCALE structure (winnt.h)

Contient la granularité de la capacité de la batterie signalée par IOCTL_BATTERY_QUERY_STATUS. Un tableau de longueur variable de structures BATTERY_REPORTING_SCALE est retourné par IOCTL_BATTERY_QUERY_INFORMATION lorsque l’informationLevel a la valeur BatteryGranularityInformation. Plusieurs entrées sont retournées lorsque la granularité dépend de la capacité actuelle de la batterie.

Syntaxe

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

Membres

Granularity

La granularité de la lecture de capacité retournée par IOCTL_BATTERY_QUERY_STATUS en milliwatt-heure (mWh). La granularité peut changer au fil du temps, car la décharge et la recharge de la batterie réduisent la plage de lectures.

Capacity

Limite de capacité supérieure pour granularité. La valeur de granularité est valide pour les capacités signalées par IOCTL_BATTERY_QUERY_STATUS qui sont inférieures ou égales à cette capacité (mWh), mais supérieures ou égales à la capacité donnée dans l’élément de tableau précédent, ou zéro s’il s’agit du premier élément de tableau.

Remarques

Le nombre total d’entrées BATTERY_REPORTING_SCALE retournées par IOCTL_BATTERY_QUERY_INFORMATION est indiqué par la valeur du paramètre lpBytesReturned de DeviceIoControl. Pour déterminer le nombre d’éléments dans le tableau, divisez la valeur de lpBytesReturned par la taille de la structure BATTERY_REPORTING_SCALE . Le nombre maximal d’entrées de tableau pouvant être retournées est de quatre.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	winnt.h (inclure Windows.h)

Voir aussi

IOCTL_BATTERY_QUERY_INFORMATION

IOCTL_BATTERY_QUERY_STATUS