estrutura PMI_CAPABILITIES (pmi.h)
A estrutura PMI_CAPABILITIES contém informações sobre os recursos de medição de energia e orçamento de um medidor de energia.
Sintaxe
typedef struct _PMI_CAPABILITIES {
ULONG Version;
ULONG Size;
PMI_CAPABILITIES_TYPE CapabilityType;
union {
PMI_REPORTED_CAPABILITIES ReportedCapabilities;
PMI_METERED_HARDWARE_INFORMATION MeteredHardwareInformation;
} Capabilities;
} PMI_CAPABILITIES, *PPMI_CAPABILITIES;
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.
CapabilityType
Um valor de enumeração PMI_CAPABILITIES_TYPE que especifica o tipo de dados do membro recursos do.
Capabilities
Uma união das estruturas de funcionalidade do PMI (Power Meter Interface) com suporte. Com base no valor do membro CapabilityType, um dos seguintes recursos submembers é usado para referenciar as seguintes estruturas de funcionalidade do PMI:
Capabilities.ReportedCapabilities
Uma estrutura PMI_METERED_HARDWARE_INFORMATION que especifica um ou mais dispositivos de hardware monitorados pelo medidor de energia.
O membro recursos do contém essa estrutura se o membro do CapabilityType estiver definido como PmiMeteredHardware.
Capabilities.MeteredHardwareInformation
Uma estrutura PMI_REPORTED_CAPABILITIES que especifica os recursos de PMI do medidor de energia, como o seguinte:
- Informações sobre ativos
- Funcionalidades de medição
- Recursos de energia e orçamento
Observações
A estrutura de PMI_CAPABILITIES é usada para consultar muitos recursos de PMI compatíveis com um medidor de energia.
As informações de funcionalidade do PMI são retornadas por meio de uma solicitação de consulta de controle de E/S (IOCTL) de IOCTL_PMI_GET_CAPABILITIES. Os dados de entrada dessa solicitação de consulta são definidos como um valor de enumerador PMI_CAPABILITIES_TYPE que especifica o tipo de dados de funcionalidade do PMI a serem retornados.
Se a solicitação de consulta IOCTL for concluída com êxito, a solicitação retornará uma estrutura PMI_CAPABILITIES. O Capabilities membro dessa estrutura contém dados formatados como a estrutura de recursos de PMI solicitada.
Por exemplo, se uma solicitação de consulta IOCTL de IOCTL_PMI_GET_CAPABILITIES for feita com os dados de entrada definidos como PmiReportedCapabilities e a solicitação for concluída com êxito, a solicitação retornará uma estrutura PMI_CAPABILITIES com seus membros definidos para os seguintes valores:
- O membro CapabilitiesType está definido como PmiReportedCapabilities.
- O membro recursos contém dados formatados como uma estrutura de PMI_REPORTED_CAPABILITIES.
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) |