PMI_EVENT结构(pmi.h)

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 事件类型的 PMI_EVENT_TYPE 枚举值。

言论

PMI_EVENT结构包含有关电力计量或预算事件的信息。 当发生以下情况之一时,PMI 将为电表生成事件:

  • 电力计量或预算功能已更改。
  • 电源计量或预算配置已更改。
  • 由电表监视的电源已超过计量配置的电源阈值。
  • 由电表监视的电源已超过或低于计量配置的电源预算。
用户模式服务或应用程序通过 IOCTL_PMI_REGISTER_EVENT_NOTIFY I/O 控件(IOCTL)查询请求注册这些事件的通知。

PMI_EVENT结构不包含事件的当前 PMI 数据。 根据 EventType 成员的值,调用方可以通过 PMI IOCTL 查询请求检索当前 PMI 数据。 下表介绍了用于查询查询请求的电源计量中更改的数据的 PMI IOCTL。

EventType 值 PMI IOCTL I/O 请求数据包(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)

另请参阅

IOCTL_PMI_GET_CAPABILITIES

IOCTL_PMI_GET_CONFIGURATION

IOCTL_PMI_REGISTER_EVENT_NOTIFY

IRP

PMI_CAPABILITIES_TYPE

PMI_CONFIGURATION_TYPE

PMI_EVENT_TYPE