estructura BATTERY_REPORTING_SCALE (winnt.h)
Contiene la granularidad de la capacidad de la batería notificada por IOCTL_BATTERY_QUERY_STATUS. Una matriz de longitud variable de BATTERY_REPORTING_SCALE estructuras se devuelve de IOCTL_BATTERY_QUERY_INFORMATION cuando InformationLevel se establece en BatteryGranularityInformation. Se devuelven varias entradas cuando la granularidad depende de la capacidad actual de la batería.
Sintaxis
typedef struct {
DWORD Granularity;
DWORD Capacity;
} BATTERY_REPORTING_SCALE, *PBATTERY_REPORTING_SCALE;
Miembros
Granularity
Granularidad de la lectura de capacidad devuelta por IOCTL_BATTERY_QUERY_STATUS en miliwatt-hours (mWh). La granularidad puede cambiar con el tiempo a medida que la descarga de la batería y la recarga reducen el intervalo de lecturas.
Capacity
Límite de capacidad superior para granularidad. El valor de Granularidad es válido para las capacidades notificadas por IOCTL_BATTERY_QUERY_STATUS que son menores o iguales que esta capacidad (mWh), pero mayor o igual que la capacidad dada en el elemento de matriz anterior, o cero si se trata del primer elemento de matriz.
Comentarios
El número total de entradas de BATTERY_REPORTING_SCALE devueltas de IOCTL_BATTERY_QUERY_INFORMATION se indica mediante el valor del parámetro lpBytesReturned de DeviceIoControl. Para determinar el número de elementos de la matriz, divida el valor de lpBytesReturned por el tamaño de la estructura BATTERY_REPORTING_SCALE . El número máximo de entradas de matriz que se pueden devolver es cuatro.
Requisitos
Requisito | Value |
---|---|
Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
Encabezado | winnt.h (incluye Windows.h) |