Compartilhar via


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
O membro Capabilities conterá essa estrutura se o membro CapabilityType estiver definido como PmiReportedCapabilities.

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)

Confira também

IOCTL_PMI_GET_CAPABILITIES

PMI_CAPABILITIES_TYPE

PMI_METERED_HARDWARE_INFORMATION

PMI_REPORTED_CAPABILITIES