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) |