PMI_REPORTED_CAPABILITIES 结构 (pmi.h)

  • 项目

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

如果仅当电源出电时才报告数据，则设置此位。 这通常适用于移动电池系统或某些不间断电源 (UPSs) 。

MeasurementUnit

一个PMI_MEASUREMENT_UNIT枚举值，该值指定度量单位。

注意 从 Windows 7、Windows Server 2008 R2 开始，仅支持毫瓦 (mW) 的度量单位。
 

MeasurementType

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

Accuracy

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

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 IOCTL (IOCTL) 查询请求返回。 此查询请求的输入数据设置为 PmiReportedCapabilities的PMI_CAPABILITIES_TYPE枚举器值。

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

要求

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

另请参阅

IOCTL_PMI_GET_CAPABILITIES

PMI_CAPABILITIES

PMI_CAPABILITIES_TYPE