PMI_CAPABILITIES 结构 (pmi.h)

  • 项目

PMI_CAPABILITIES结构包含有关功率计量和功率计预算功能的信息。

语法

typedef struct _PMI_CAPABILITIES {
  ULONG                 Version;
  ULONG                 Size;
  PMI_CAPABILITIES_TYPE CapabilityType;
  union {
    PMI_REPORTED_CAPABILITIES        ReportedCapabilities;
    PMI_METERED_HARDWARE_INFORMATION MeteredHardwareInformation;
  } Capabilities;
} PMI_CAPABILITIES, *PPMI_CAPABILITIES;

成员

Version

一个 值，该值指定此结构的版本。 对于 Windows 7、Windows Server 2008 R2 及更高版本的 Windows，此值必须为 1。

Size

一个值，以字节为单位，指定结构的大小。

CapabilityType

一个PMI_CAPABILITIES_TYPE枚举值，该值指定 Capabilities 成员的数据类型。

Capabilities

支持的功率计接口 (PMI) 功能结构的联合。 根据 CapabilityType 成员的值，以下 功能 子成员之一用于引用以下 PMI 功能结构：

Capabilities.ReportedCapabilities

一种PMI_METERED_HARDWARE_INFORMATION结构，指定由功率计监视的一个或多个硬件设备。

如果 CapabilityType 成员设置为 PmiMeteredHardware，则 Capabilities 成员包含此结构。

Capabilities.MeteredHardwareInformation

指定功率计 PMI 功能的 PMI_REPORTED_CAPABILITIES 结构，如下所示：

  • 资产信息
  • 度量功能
  • 电源和预算功能
如果 CapabilityType 成员设置为 PmiReportedCapabilities，则 Capabilities 成员将包含此结构。

注解

PMI_CAPABILITIES结构用于查询功率计支持的许多 PMI 功能。

PMI 功能信息通过 IOCTL_PMI_GET_CAPABILITIES I/O 控件 (IOCTL) 查询请求返回。 此查询请求的输入数据设置为 PMI_CAPABILITIES_TYPE 枚举器值，该值指定要返回的 PMI 功能数据的类型。

如果 IOCTL 查询请求成功完成，则请求将返回PMI_CAPABILITIES结构。 此结构的 Capabilities 成员包含格式化为所请求的 PMI 功能结构的数据。

例如，如果输入数据集设置为 PmiReportedCapabilities 发出IOCTL_PMI_GET_CAPABILITIES的 IOCTL 查询请求，并且请求成功完成，则请求将返回一个PMI_CAPABILITIES结构，其成员设置为以下值：

  • CapabilitiesType 成员设置为 PmiReportedCapabilities。
  • Capabilities 成员包含格式化为PMI_REPORTED_CAPABILITIES结构的数据。

要求

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

另请参阅

IOCTL_PMI_GET_CAPABILITIES

PMI_CAPABILITIES_TYPE

PMI_METERED_HARDWARE_INFORMATION

PMI_REPORTED_CAPABILITIES