estrutura PMI_EVENT (pmi.h)

Artigo
08/07/2023

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

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 PMI_EVENT_TYPE valor de enumeração que especifica o tipo de evento PMI.

Comentários

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 ficou 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 ioctl (controle de E/S) 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 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	IRP (pacote de solicitação de E/S)
PmiCapabilitiesChangedEvent	IOCTL_PMI_GET_CAPABILITIES	O membro AssociatedIrp.SystemBuffer é definido como o endereço de um buffer alocado pelo iniciador que contém qualquer PMI_CAPABILITIES_TYPE valor de enumeração.
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
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)