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
支持的电源计量接口(PMI)功能结构的联合。 根据 CapabilityType 成员的值,以下 功能 子成员之一用于引用以下 PMI 功能结构:
Capabilities.ReportedCapabilities
一个 PMI_METERED_HARDWARE_INFORMATION 结构,它指定一个或多个由电源表监视的硬件设备。
如果 CapabilityType 成员设置为 PmiMeteredHardware,则 功能 成员包含此结构。
Capabilities.MeteredHardwareInformation
一个 PMI_REPORTED_CAPABILITIES 结构,用于指定电表的 PMI 功能,如下所示:
- 资产信息
- 度量功能
- 电源和预算功能
言论
PMI_CAPABILITIES结构用于查询电源表支持的许多 PMI 功能。
PMI 功能信息通过 IOCTL_PMI_GET_CAPABILITIES I/O 控件(IOCTL)查询请求返回。 此查询请求的输入数据设置为 PMI_CAPABILITIES_TYPE 枚举器值,该值指定要返回的 PMI 功能数据类型。
如果 IOCTL 查询请求成功完成,则请求将返回PMI_CAPABILITIES结构。 此结构的 功能 成员包含格式化为所请求的 PMI 功能结构的数据。
例如,如果使用输入数据集 IOCTL_PMI_GET_CAPABILITIES 的 IOCTL 查询请求 PmiReportedCapabilities 并且请求成功完成,则请求将返回一个PMI_CAPABILITIES结构,其成员设置为以下值:
- CapabilitiesType 成员设置为 PmiReportedCapabilities。
- 功能 成员包含格式化为 PMI_REPORTED_CAPABILITIES 结构的数据。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | 在 Windows 7、Windows Server 2008 R2 和更高版本的 Windows作系统中可用。 |
标头 | pmi.h (包括 Pmi.h) |