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 PMI_CAPABILITIES_TYPE valor de enumeração que especifica o tipo de dados do membro Capabilities .
Capabilities
Uma união das estruturas de funcionalidade de PMI (Interface do Medidor de Energia) com suporte. Com base no valor do membro CapabilityType , um dos seguintes submembros capabilities é usado para referenciar as seguintes estruturas de funcionalidade pmi:
Capabilities.ReportedCapabilities
Uma estrutura PMI_METERED_HARDWARE_INFORMATION que especifica um ou mais dispositivos de hardware monitorados pelo medidor de energia.
O membro Capabilities conterá essa estrutura se o membro 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
Comentários
A estrutura 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 ioctl (controle de E/S) de IOCTL_PMI_GET_CAPABILITIES . Os dados de entrada dessa solicitação de consulta são definidos como um valor PMI_CAPABILITIES_TYPE enumerador que especifica o tipo de dados de funcionalidade 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 membro Capabilities dessa estrutura contém dados formatados como a estrutura de funcionalidades 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 com os seguintes valores:
- O membro CapabilitiesType é definido como PmiReportedCapabilities.
- O membro Capabilities contém dados formatados 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) |