estrutura PMI_EVENT (pmi.h)

Artigo
02/07/2025

A estrutura PMI_EVENT contém informações sobre um evento de medição de energia e orçamento que é sinalizado por meio do PMI (Power Meter Interface).

Sintaxe

typedef struct _PMI_EVENT {
  ULONG          Version;
  PMI_EVENT_TYPE EventType;
} PMI_EVENT, *PPMI_EVENT;

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.

EventType

Um valor de enumeração PMI_EVENT_TYPE que especifica o tipo de evento PMI.

Observações

A estrutura PMI_EVENT contém informações sobre um evento de medição de energia ou orçamento. O PMI gera um evento para um medidor de energia quando ocorre um destes procedimentos:

Os recursos de medição de energia ou orçamento do medidor de energia foram alterados.
As configurações de medição de energia ou orçamento do medidor de energia foram alteradas.
A fonte de alimentação monitorada pelo medidor de energia excedeu o limite de energia configurado do medidor.
A fonte de alimentação monitorada pelo medidor de energia excedeu ou caiu abaixo do orçamento de energia configurado do medidor.

Um serviço ou aplicativo no modo de usuário se registra para notificação desses eventos por meio de uma solicitação de consulta de controle de E/S (IOCTL) de IOCTL_PMI_REGISTER_EVENT_NOTIFY.

A estrutura PMI_EVENT não contém os dados atuais do PMI para o evento. Dependendo do valor do membro EventType, o chamador pode recuperar os dados atuais do PMI por meio de uma solicitação de consulta IOCTL do PMI. A tabela a seguir descreve o PMI IOCTL a ser usado para consultar os dados alterados de um medidor de energia para uma solicitação de consulta.

Valor eventType	PMI IOCTL	Pacote de solicitação de E/S (IRP)
PmiCapabilitiesChangedEvent	IOCTL_PMI_GET_CAPABILITIES	O membro AssociatedIrp.SystemBuffer é definido como o endereço de um buffer alocado pelo iniciador que contém qualquer valor de enumeração PMI_CAPABILITIES_TYPE.
PmiConfigurationChangedEvent	IOCTL_PMI_GET_CONFIGURATION	O membro AssociatedIrp.SystemBuffer é definido como o endereço de um buffer alocado pelo iniciador que contém qualquer PMI_CONFIGURATION_TYPE valor de enumeração.
PmiThresholdEvent	IOCTL_PMI_GET_CONFIGURATION	O membro AssociatedIrp.SystemBuffer é definido como o endereço de um buffer alocado pelo iniciador que contém o valor de enumeração PMI_CONFIGURATION_TYPE ou PmiThresholdConfiguration.
PmiBudgetEvent	IOCTL_PMI_GET_CONFIGURATION	O membro AssociatedIrp.SystemBuffer é definido como o endereço de um buffer alocado pelo iniciador que contém o valor de enumeração PMI_CONFIGURATION_TYPE ou PmiBudgetConfiguration.
PmiAveragingIntervalChangedEvent	IOCTL_PMI_GET_CONFIGURATION	O membro AssociatedIrp.SystemBuffer é definido como o endereço de um buffer alocado pelo iniciador que contém o valor de enumeração PMI_CONFIGURATION_TYPE ou PmiMeasurementConfiguration.

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)