Compartir a través de


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)

Consulte también

IOCTL_BATTERY_QUERY_INFORMATION

IOCTL_BATTERY_QUERY_STATUS