estrutura PMI_CONFIGURATION (pmi.h)
A estrutura PMI_CONFIGURATION contém informações sobre a configuração atual de medição de energia e orçamento de um medidor de energia.
Sintaxe
typedef struct _PMI_CONFIGURATION {
ULONG Version;
USHORT Size;
PMI_CONFIGURATION_TYPE ConfigurationType;
union {
PMI_MEASUREMENT_CONFIGURATION MeasurementConfiguration;
PMI_BUDGETING_CONFIGURATION BudgetingConfiguration;
PMI_THRESHOLD_CONFIGURATION ThresholdConfiguration;
} Configuration;
} PMI_CONFIGURATION, *PPMI_CONFIGURATION;
Membros
Version
Um valor que especifica a versão dessa estrutura. Para Windows 7, Windows Server 2008 R2 e versões posteriores do Windows, esse valor deve ser 1.
Size
Um valor, em unidades de bytes, que especifica o tamanho da estrutura.
ConfigurationType
Um valor de enumeração PMI_CONFIGURATION_TYPE que especifica o tipo de dados do membro de Configuração do.
Configuration
Uma união das estruturas de configuração do PMI (Power Meter Interface) com suporte. Com base no valor do membro ConfigurationType, um dos seguintes submembros de Configuração é usado para referenciar as seguintes estruturas de configuração do PMI:
Configuration.MeasurementConfiguration
Uma estrutura PMI_BUDGETING_CONFIGURATION que contém informações sobre a configuração de orçamento do medidor de energia.
O membro de Configuração do contém essa estrutura se o membro ConfigurationType estiver definido como PmiBudgetingConfiguration.
Configuration.BudgetingConfiguration
Uma estrutura PMI_MEASUREMENT_CONFIGURATION que contém informações sobre a configuração de medida do medidor de energia.
O membro de Configuração do contém essa estrutura se o membro ConfigurationType estiver definido como PmiMeasurementConfiguration.
Configuration.ThresholdConfiguration
Uma estrutura PMI_THRESHOLD_CONFIGURATION que contém informações sobre a configuração de limite do medidor de energia.
O membro de Configuração do contém essa estrutura se o membro ConfigurationType estiver definido como PmiThresoldConfiguration.
Observações
A estrutura PMI_CONFIGURATION é usada para consultar várias configurações de PMI diferentes compatíveis com um medidor de energia.
As informações de configuração do PMI são retornadas por meio de uma solicitação de consulta de controle de E/S (IOCTL) de IOCTL_PMI_GET_CONFIGURATION. Os dados de entrada dessa solicitação de consulta são definidos como um valor de enumerador PMI_CONFIGURATION_TYPE que especifica o tipo de dados de configuração do PMI a serem retornados.
Se a solicitação de consulta IOCTL for concluída com êxito, a solicitação retornará uma estrutura PMI_CONFIGURATION. O membro de Configuração de dessa estrutura contém dados formatados como a estrutura de configuração do PMI solicitada.
Por exemplo, se uma solicitação de consulta IOCTL de IOCTL_PMI_GET_CONFIGURATION for feita com os dados de entrada definidos para PmiBudgetingConfiguration e a solicitação for concluída com êxito, a solicitação retornará uma estrutura PMI_CONFIGURATION com seus membros definidos para os seguintes valores:
- O membro ConfigurationType está definido como PmiBudgetingConfiguration.
- O membro de Configuração de contém dados formatados como uma estrutura de PMI_BUDGETING_CONFIGURATION.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível no Windows 7, Windows Server 2008 R2 e versões posteriores dos sistemas operacionais Windows. |
| cabeçalho | pmi.h (inclua Pmi.h) |