estrutura PMI_REPORTED_CAPABILITIES (pmi.h)

Artigo
08/07/2023

A estrutura PMI_REPORTED_CAPABILITIES contém informações sobre o tipo de capacidade de medição de energia e orçamento que um medidor de energia dá suporte. Além disso, essa estrutura contém informações de ativo sobre o próprio medidor de energia.

Sintaxe

typedef struct _PMI_REPORTED_CAPABILITIES {
  ULONG                Flags;
  PMI_MEASUREMENT_UNIT MeasurementUnit;
  PMI_MEASUREMENT_TYPE MeasurementType;
  ULONG                Accuracy;
  ULONG                SamplingPeriod;
  ULONG                MinimumAverageInterval;
  ULONG                MaximumAverageInterval;
  ULONG                Hysteresis;
  BOOLEAN              Writeable;
  ULONG                MinBudget;
  ULONG                MaxBudget;
  WCHAR                ModelNumber[PMI_NAME_MAX];
  WCHAR                SerialNumber[PMI_NAME_MAX];
  WCHAR                OEMInformation[PMI_NAME_MAX];
} PMI_REPORTED_CAPABILITIES, *PPMI_REPORTED_CAPABILITIES;

Membros

Flags

Uma máscara de bits que especifica os recursos com suporte do medidor de energia. Os seguintes sinalizadores definem o intervalo de valores para este membro:

PMI_CAPABILITIES_SUPPORT_MEASUREMENT

Esse bit será definido se o medidor de energia der suporte à medição de energia.

PMI_CAPABILITIES_SUPPORT_THRESHOLDS

Esse bit será definido se o medidor de energia der suporte a limites de energia.

PMI_CAPABILITIES_SUPPORT_BUDGETING

Esse bit será definido se o medidor de energia der suporte ao orçamento de energia.

PMI_CAPABILITIES_DISCHARGE_ONLY

Esse bit será definido se o medidor de energia relatar dados somente quando a fonte de alimentação estiver descarregando. Normalmente, esse é o caso em sistemas de bateria móveis ou alguns UPSs (fontes de alimentação ininterruptas).

MeasurementUnit

Um PMI_MEASUREMENT_UNIT valor de enumeração que especifica a unidade de medida.

Nota A partir do Windows 7, Windows Server 2008 R2, há suporte apenas para unidades de medição de miliwatts (mW).

MeasurementType

Um PMI_MEASUREMENT_TYPE valor de enumeração que especifica o tipo de medida, como se a potência de entrada ou saída é medida.

Accuracy

Um valor, em unidades de milésimos de porcentagem, que especifica a precisão relatada do medidor de energia. Por exemplo, um valor de 1.000 corresponde a uma classificação de precisão de um por cento.

SamplingPeriod

Um valor, em unidades de milissegundos, que especifica o período de média atual.

MinimumAverageInterval

Um valor, em unidades de milissegundos, que especifica o intervalo de média mínimo.

MaximumAverageInterval

Um valor, em unidades de milissegundos, que especifica o intervalo médio máximo.

Hysteresis

Um valor, em unidades de milissegundos, que especifica o valor de histerese. Esse valor indica a margem criada em torno dos eventos de limite e orçamento. Esse valor impede o gatilho de eventos desnecessários quando a leitura flutua muito perto de um dos limites.

Writeable

Um valor booliano que indica se as informações de orçamento são TRUE (leitura/gravação) ou somente leitura (FALSE).

MinBudget

Um valor, em unidades de watts, que especifica o orçamento mínimo de energia com suporte.

MaxBudget

Um valor, em unidades de watts, que especifica o orçamento máximo de energia com suporte.

ModelNumber[PMI_NAME_MAX]

Uma cadeia de caracteres Unicode terminada em nulo que contém o número do modelo do medidor de energia.

SerialNumber[PMI_NAME_MAX]

Uma cadeia de caracteres Unicode terminada em nulo que contém o número de série do medidor de energia.

OEMInformation[PMI_NAME_MAX]

Uma cadeia de caracteres Unicode terminada em nulo que contém informações descritivas sobre o medidor de energia. Essas informações são específicas para a implementação pelo OEM original.

Comentários

A estrutura PMI_REPORTED_CAPABILITIES contém as seguintes informações sobre um medidor de energia:

As funcionalidades de medição do medidor de energia.
Os recursos de orçamento do medidor de energia, que incluem se a configuração de orçamento pode ser alterada.
As informações de ativo do medidor de energia. Essas informações são definidas pelo OEM para o medidor de energia.

A estrutura PMI_REPORTED_CAPABILITIES é retornada por meio de uma solicitação de consulta ioctl (controle de E/S) de IOCTL_PMI_GET_CAPABILITIES . Os dados de entrada dessa solicitação de consulta são definidos como o valor PMI_CAPABILITIES_TYPE enumerador de PmiReportedCapabilities..

Se a solicitação de consulta for concluída com êxito, a solicitação retornará uma estrutura PMI_CAPABILITIES . O membro Capabilities dessa estrutura é formatado como uma estrutura PMI_REPORTED_CAPABILITIES.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Windows 7, Windows Server 2008 R2 e versões posteriores dos sistemas operacionais Windows.
Cabeçalho	pmi.h (inclua Pmi.h)