Поделиться через

структура 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 один из следующих вложенных элементов Configuration используется для ссылки на следующие структуры конфигурации PMI:

Configuration.MeasurementConfiguration

Структура PMI_BUDGETING_CONFIGURATION , содержащая сведения о конфигурации бюджетирования счетчика мощности.

Элемент конфигурации содержит эту структуру, если для элемента ConfigurationType задано значение PmiBudgetingConfiguration.

Configuration.BudgetingConfiguration

Структура PMI_MEASUREMENT_CONFIGURATION, содержащая сведения о конфигурации измерения счетчика мощности.

Элемент Конфигурации содержит эту структуру, если для элемента ConfigurationType задано значение PmiMeasurementConfiguration.

Configuration.ThresholdConfiguration

Структура PMI_THRESHOLD_CONFIGURATION , содержащая сведения о конфигурации порогового значения счетчика мощности.

Элемент Конфигурации содержит эту структуру, если для элемента ConfigurationType задано значение PmiThresoldConfiguration.

Комментарии

Структура PMI_CONFIGURATION используется для запроса различных параметров конфигурации PMI, поддерживаемых счетчиком мощности.

Сведения о конфигурации PMI возвращаются с помощью запроса IOCTL_PMI_GET_CONFIGURATION управления вводом-выводом (IOCTL). Входные данные этого запроса задаются как PMI_CONFIGURATION_TYPE значение перечислителя, указывающее тип возвращаемых данных конфигурации PMI.

Если запрос IOCTL успешно завершается, запрос возвращает PMI_CONFIGURATION структуру. Элемент Конфигурации этой структуры содержит данные, отформатированные как запрошенная структура конфигурации PMI.

Например, если запрос IOCTL IOCTL_PMI_GET_CONFIGURATION выполняется с набором входных данных PmiBudgetingConfiguration и запрос завершается успешно, запрос возвращает структуру PMI_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