PMI_BUDGETING_CONFIGURATION structure (pmi.h)

The PMI_BUDGETING_CONFIGURATION structure contains information about the current power budget of a power meter. A power budget defines how much power that the system can consume from the set of power supplies monitored by the power meter.

Syntax

typedef struct _PMI_BUDGETING_CONFIGURATION {
  ULONG ConfiguredBudget;
} PMI_BUDGETING_CONFIGURATION, *PPMI_BUDGETING_CONFIGURATION;

Members

ConfiguredBudget

A value, in units of milliwatts (mW), that specifies the current power budget. A value of zero indicates that the power budget is not enabled on the power meter.

Remarks

The PMI_BUDGETING_CONFIGURATION structure is returned through an IOCTL_PMI_GET_CONFIGURATION I/O control (IOCTL) query request. This query request has its input data set to a PMI_CONFIGURATION_TYPE enumerator value of PmiBudgetingConfiguration.

If the IOCTL query request completes successfully, the request returns a PMI_CONFIGURATION structure with its Capabilities member formatted as a PM_BUDGETING_CONFIGURATION structure.

Unlike other PMI capability or configuration data, the power meter's current budgeting configuration can be changed. This is only possible if an IOCTL query request of IOCTL_PMI_GET_CAPABILITIES returns a PMI_REPORTED_CAPABILITIES structure with the Writeable member set to TRUE. In this case, the budgeting configuration for the power meter can be changed through a set request of IOCTL_PMI_SET_CONFIGURATION.

Requirements

Requirement Value
Minimum supported client Available in Windows 7, Windows Server 2008 R2, and later versions of the Windows operating systems.
Header pmi.h (include Pmi.h)

See also

IOCTL_PMI_GET_CAPABILITIES

IOCTL_PMI_GET_CONFIGURATION

IOCTL_PMI_SET_CONFIGURATION

PMI_CONFIGURATION

PMI_CONFIGURATION_TYPE

PMI_REPORTED_CAPABILITIES