Compartilhar via


estrutura BATTERY_REPORTING_SCALE (winnt.h)

Contém a granularidade da capacidade da bateria relatada por IOCTL_BATTERY_QUERY_STATUS. Uma matriz de comprimento variável de estruturas BATTERY_REPORTING_SCALE é retornada de IOCTL_BATTERY_QUERY_INFORMATION quando InformationLevel é definido como BatteryGranularityInformation. Várias entradas são retornadas quando a granularidade depende da capacidade atual da bateria.

Sintaxe

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

Membros

Granularity

A granularidade da leitura de capacidade retornada por IOCTL_BATTERY_QUERY_STATUS em miliwatts-horas (mWh). A granularidade pode mudar ao longo do tempo à medida que a descarga da bateria e a recarga reduzem o intervalo de leituras.

Capacity

O limite de capacidade superior para Granularidade. O valor de Granularidade é válido para capacidades relatadas por IOCTL_BATTERY_QUERY_STATUS que são menores ou iguais a essa capacidade (mWh), mas maior ou igual à capacidade fornecida no elemento de matriz anterior ou zero se esse for o primeiro elemento de matriz.

Comentários

O número total de entradas BATTERY_REPORTING_SCALE retornadas de IOCTL_BATTERY_QUERY_INFORMATION é indicado pelo valor do parâmetro lpBytesReturned de DeviceIoControl. Para determinar o número de elementos na matriz, divida o valor de lpBytesReturned pelo tamanho da estrutura BATTERY_REPORTING_SCALE . O número máximo de entradas de matriz que podem ser retornadas é quatro.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho winnt.h (inclua Windows.h)

Confira também

IOCTL_BATTERY_QUERY_INFORMATION

IOCTL_BATTERY_QUERY_STATUS