PMI_CONFIGURATION 结构 (pmi.h)

  • 项目

PMI_CONFIGURATION结构包含有关功率计当前功率计量和预算配置的信息。

语法

typedef struct _PMI_CONFIGURATION {
  ULONG                  Version;
  USHORT                 Size;
  PMI_CONFIGURATION_TYPE ConfigurationType;
  union {
    PMI_MEASUREMENT_CONFIGURATION MeasurementConfiguration;
    PMI_BUDGETING_CONFIGURATION   BudgetingConfiguration;
    PMI_THRESHOLD_CONFIGURATION   ThresholdConfiguration;
  } Configuration;
} PMI_CONFIGURATION, *PPMI_CONFIGURATION;

成员

Version

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

Size

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

ConfigurationType

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

Configuration

支持的 Power Meter 接口的联合 (PMI) 配置结构。 根据 ConfigurationType 成员的值，以下 配置 子成员之一用于引用以下 PMI 配置结构：

Configuration.MeasurementConfiguration

包含有关功率计预算配置的信息 的PMI_BUDGETING_CONFIGURATION 结构。

如果 ConfigurationType 成员设置为 PmiBudgetingConfiguration，则 Configuration 成员将包含此结构。

Configuration.BudgetingConfiguration

一个 PMI_MEASUREMENT_CONFIGURATION 结构，其中包含有关功率计测量配置的信息。

如果 ConfigurationType 成员设置为 PmiMeasurementConfiguration，则 Configuration 成员将包含此结构。

Configuration.ThresholdConfiguration

包含有关功率计阈值配置的信息 的PMI_THRESHOLD_CONFIGURATION 结构。

如果 ConfigurationType 成员设置为 PmiThresoldConfiguration，则 Configuration 成员将包含此结构。

注解

PMI_CONFIGURATION结构用于查询功率计支持的许多不同的 PMI 配置设置。

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

如果 IOCTL 查询请求成功完成，则请求将返回PMI_CONFIGURATION结构。 此结构的 Configuration 成员包含格式化为请求的 PMI 配置结构的数据。

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

  • ConfigurationType 成员设置为 PmiBudgetingConfiguration。
  • Configuration 成员包含格式化为PMI_BUDGETING_CONFIGURATION结构的数据。

要求

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

另请参阅

IOCTL_PMI_GET_CONFIGURATION

PMI_BUDGETING_CONFIGURATION

PMI_CONFIGURATION_TYPE

PMI_MEASUREMENT_CONFIGURATION

PMI_THRESHOLD_CONFIGURATION