структура PMI_EVENT (pmi.h)

Статья
02/26/2024

Структура PMI_EVENT содержит сведения о событии учета электроэнергии и бюджетирования, которые передаются через интерфейс счетчика мощности (PMI).

Синтаксис

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

Члены

Version

Значение типа , указывающее версию этой структуры. Для Windows 7, Windows Server 2008 R2 и более поздних версий Windows это значение должно быть равно 1.

EventType

Значение перечисления PMI_EVENT_TYPE , указывающее тип события PMI.

Структура PMI_EVENT содержит сведения о событии учета электроэнергии или бюджетирования. PMI создает событие для счетчика мощности при возникновении одного из следующих событий:

Возможности учета электроэнергии или бюджетирования счетчика электроэнергии изменились.
Изменились конфигурации счетчика электроэнергии или бюджетирования.
Блок питания, отслеживаемый счетчиком электроэнергии, превысил пороговое значение, заданное счетчиком.
Блок питания, отслеживаемый электросчетчиком, превысил или опустился ниже заданного бюджета.

Служба или приложение в пользовательском режиме регистрируется для уведомления об этих событиях с помощью запроса IOCTL_PMI_REGISTER_EVENT_NOTIFY элемента управления вводом-выводом (IOCTL).

Структура PMI_EVENT не содержит текущих данных PMI для события. В зависимости от значения элемента EventType вызывающий объект может получить текущие данные PMI с помощью запроса IOCTL PMI. В следующей таблице описывается IOCTL PMI, используемый для запроса измененных данных от счетчика мощности.

Значение EventType	PMI IOCTL	Пакет запроса ввода-вывода (IRP)
PmiCapabilitiesChangedEvent	IOCTL_PMI_GET_CAPABILITIES	Член AssociatedIrp.SystemBuffer имеет адрес буфера, выделенного инициатором, который содержит любое значение перечисления PMI_CAPABILITIES_TYPE .
PmiConfigurationChangedEvent	IOCTL_PMI_GET_CONFIGURATION	Член AssociatedIrp.SystemBuffer имеет адрес буфера, выделенного инициатором, который содержит любое значение перечисления PMI_CONFIGURATION_TYPE .
PmiThresholdEvent	IOCTL_PMI_GET_CONFIGURATION	Член AssociatedIrp.SystemBuffer имеет адрес буфера, выделенного инициатором, который содержит значение перечисления PMI_CONFIGURATION_TYPE или PmiThresholdConfiguration.
PmiBudgetEvent	IOCTL_PMI_GET_CONFIGURATION	Член AssociatedIrp.SystemBuffer имеет адрес буфера, выделенного инициатором, который содержит значение перечисления PMI_CONFIGURATION_TYPE или PmiBudgetConfiguration.
PmiAveragingIntervalChangedEvent	IOCTL_PMI_GET_CONFIGURATION	Член AssociatedIrp.SystemBuffer имеет адрес буфера, выделенного инициатором, который содержит значение перечисления PMI_CONFIGURATION_TYPE или PmiMeasurementConfiguration.

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows 7, Windows Server 2008 R2 и более поздних версиях операционных систем Windows.
Верхняя часть	pmi.h (включая Pmi.h)