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 将为电表生成事件:
- 电力计量或预算功能已更改。
- 电源计量或预算配置已更改。
- 由电表监视的电源已超过计量配置的电源阈值。
- 由电表监视的电源已超过或低于计量配置的电源预算。
PMI_EVENT结构不包含事件的当前 PMI 数据。 根据 EventType 成员的值,调用方可以通过 PMI IOCTL 查询请求检索当前 PMI 数据。 下表介绍了用于查询查询请求的电源计量中更改的数据的 PMI IOCTL。
EventType 值 | PMI IOCTL | I/O 请求数据包(IRP) |
---|---|---|
PmiCapabilitiesChangedEvent | AssociatedIrp.SystemBuffer 成员设置为包含任何 PMI_CAPABILITIES_TYPE 枚举值的发起程序分配缓冲区的地址。 | |
PmiConfigurationChangedEvent | AssociatedIrp.SystemBuffer 成员设置为包含任何 PMI_CONFIGURATION_TYPE 枚举值的发起程序分配缓冲区的地址。 | |
PmiThresholdEvent | AssociatedIrp.SystemBuffer 成员设置为包含 PMI_CONFIGURATION_TYPE 枚举值或 PmiThresholdConfiguration的发起程序分配缓冲区的地址。 | |
PmiBudgetEvent | AssociatedIrp.SystemBuffer 成员设置为包含 PMI_CONFIGURATION_TYPE 枚举值或 PmiBudgetConfiguration的发起程序分配缓冲区的地址。 | |
PmiAveragingIntervalChangedEvent | AssociatedIrp.SystemBuffer 成员设置为包含 PMI_CONFIGURATION_TYPE 枚举值或 PmiMeasurementConfiguration的发起程序分配缓冲区的地址。 |
要求
要求 | 价值 |
---|---|
最低支持的客户端 | 在 Windows 7、Windows Server 2008 R2 和更高版本的 Windows作系统中可用。 |
标头 | pmi.h (包括 Pmi.h) |