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) |