PMI_REPORTED_CAPABILITIES结构（pmi.h）

项目
02/07/2025

PMI_REPORTED_CAPABILITIES结构包含有关电表支持的电源计量和预算功能类型的信息。此外，此结构包含有关电表本身的资产信息。

语法

typedef struct _PMI_REPORTED_CAPABILITIES {
  ULONG                Flags;
  PMI_MEASUREMENT_UNIT MeasurementUnit;
  PMI_MEASUREMENT_TYPE MeasurementType;
  ULONG                Accuracy;
  ULONG                SamplingPeriod;
  ULONG                MinimumAverageInterval;
  ULONG                MaximumAverageInterval;
  ULONG                Hysteresis;
  BOOLEAN              Writeable;
  ULONG                MinBudget;
  ULONG                MaxBudget;
  WCHAR                ModelNumber[PMI_NAME_MAX];
  WCHAR                SerialNumber[PMI_NAME_MAX];
  WCHAR                OEMInformation[PMI_NAME_MAX];
} PMI_REPORTED_CAPABILITIES, *PPMI_REPORTED_CAPABILITIES;

成员

Flags

一个位掩码，指定电源表支持的功能。以下标志定义此成员的值范围：

PMI_CAPABILITIES_SUPPORT_MEASUREMENT

如果功率计支持电源测量，则设置此位。

PMI_CAPABILITIES_SUPPORT_THRESHOLDS

如果电源计支持电源阈值，则设置此位。

PMI_CAPABILITIES_SUPPORT_BUDGETING

如果电源计量支持电源预算，则设置此位。

PMI_CAPABILITIES_DISCHARGE_ONLY

如果电源表仅当电源正在充电时报告数据，则设置此位。这通常是在移动电池系统或一些不间断电源（UPS）上的情况。

MeasurementUnit

指定度量单位的 PMI_MEASUREMENT_UNIT 枚举值。

注意， 从 Windows 7 开始，Windows Server 2008 R2 仅支持米瓦特（mW）的度量单位。

MeasurementType

一个指定度量类型的 PMI_MEASUREMENT_TYPE 枚举值，例如是否测量输入或输出功率。

Accuracy

一个值，以百分之几的百分比为单位，指定报告功率计的准确性。例如，值为 1,000 对应于百分之一的准确性评级。

SamplingPeriod

一个值（以毫秒为单位），指定当前平均周期。

MinimumAverageInterval

一个值（以毫秒为单位），指定最小平均间隔。

MaximumAverageInterval

一个值（以毫秒为单位），指定最大平均间隔。

Hysteresis

一个值，以毫秒为单位，指定滞后值。此值指示围绕阈值和预算事件生成的边距。当读取波动非常接近某个阈值时，此值可防止触发不必要的事件。

Writeable

一个布尔值，该值指示预算信息是读/写（TRUE）还是只读（FALSE）。

MinBudget

一个值（以瓦为单位）指定支持的最小电源预算。

MaxBudget

一个值（以瓦为单位），指定支持的最大电源预算。

ModelNumber[PMI_NAME_MAX]

一个以 null 结尾的 Unicode 字符串，其中包含电表的型号。

SerialNumber[PMI_NAME_MAX]

一个以 null 结尾的 Unicode 字符串，其中包含电表的序列号。

OEMInformation[PMI_NAME_MAX]

以 null 结尾的 Unicode 字符串，其中包含有关电表的描述性信息。此信息特定于原始 OEM 的实现。

言论

PMI_REPORTED_CAPABILITIES结构包含有关电表的以下信息：

电表的测量功能。
电源表的预算功能，包括是否可以更改预算配置。
电表的资产信息。此信息由电源表的 OEM 定义。

PMI_REPORTED_CAPABILITIES结构通过 IOCTL_PMI_GET_CAPABILITIES I/O 控件（IOCTL）查询请求返回。此查询请求的输入数据设置为 PmiReportedCapabilities.PMI_CAPABILITIES_TYPE 枚举器值。

如果查询请求成功完成，则请求将返回 PMI_CAPABILITIES 结构。此结构的功能成员的格式设置为PMI_REPORTED_CAPABILITIES结构。

要求

要求	价值
最低支持的客户端	在 Windows 7、Windows Server 2008 R2 和更高版本的 Windows作系统中可用。
标头	pmi.h （包括 Pmi.h）

另请参阅

IOCTL_PMI_GET_CAPABILITIES

PMI_CAPABILITIES

PMI_CAPABILITIES_TYPE

通过