структура PMI_REPORTED_CAPABILITIES (pmi.h)

Статья
02/07/2025

Структура PMI_REPORTED_CAPABILITIES содержит сведения о типе возможностей измерения электроэнергии и бюджетирования, поддерживаемых счетчиком электроэнергии. Кроме того, эта структура содержит сведения об активе о самом счетчике питания.

Синтаксис

typedef struct _PMI_REPORTED_CAPABILITIES {
  ULONG                Flags;
  PMI_MEASUREMENT_UNIT MeasurementUnit;
  PMI_MEASUREMENT_TYPE MeasurementType;
  ULONG                Accuracy;
  ULONG                SamplingPeriod;
  ULONG                MinimumAverageInterval;
  ULONG                MaximumAverageInterval;
  ULONG                Hysteresis;
  BOOLEAN              Writeable;
  ULONG                MinBudget;
  ULONG                MaxBudget;
  WCHAR                ModelNumber[PMI_NAME_MAX];
  WCHAR                SerialNumber[PMI_NAME_MAX];
  WCHAR                OEMInformation[PMI_NAME_MAX];
} PMI_REPORTED_CAPABILITIES, *PPMI_REPORTED_CAPABILITIES;

Члены

Flags

Битовая маска, указывающая поддерживаемые возможности счетчика электроэнергии. Следующие флаги определяют диапазон значений для этого элемента:

PMI_CAPABILITIES_SUPPORT_MEASUREMENT

Этот бит задается, если счетчик питания поддерживает измерение мощности.

PMI_CAPABILITIES_SUPPORT_THRESHOLDS

Этот бит задается, если счетчик питания поддерживает пороговые значения питания.

PMI_CAPABILITIES_SUPPORT_BUDGETING

Этот бит задается, если счетчик питания поддерживает бюджет питания.

PMI_CAPABILITIES_DISCHARGE_ONLY

Этот бит задается, если счетчик питания сообщает данные только при отключении питания. Как правило, это касается мобильных аккумуляторных систем или некоторых неинтерпретируемых источников питания (UPS).

MeasurementUnit

Значение перечисления PMI_MEASUREMENT_UNIT, указывающее единицу измерения.

Примечание начиная с Windows 7, Windows Server 2008 R2, поддерживаются только единицы измерения милливатт (mW).

MeasurementType

Значение перечисления PMI_MEASUREMENT_TYPE, указывающее тип измерения, например, измеряется ли входная или выходная мощность.

Accuracy

Значение в единицах тысяч процентов, указывающее точность счетчика электроэнергии. Например, значение 1000 соответствует оценке точности на один процент.

SamplingPeriod

Значение в единицах миллисекундах, указывающее текущий промежуточный период.

MinimumAverageInterval

Значение в единицах миллисекундах, указывающее минимальный промежуточный интервал.

MaximumAverageInterval

Значение в единицах миллисекундах, указывающее максимальный интервал усреднения.

Hysteresis

Значение в единицах миллисекундах, указывающее значение гистериса. Это значение указывает на поле, созданное вокруг порогового значения и событий бюджета. Это значение предотвращает триггер ненужных событий, когда чтение колеблется очень близко к одному из пороговых значений.

Writeable

Логическое значение, указывающее, является ли информация о бюджете чтением и записью (TRUE) или только для чтения (FALSE).

MinBudget

Значение в единицах ватт, указывающее минимальный поддерживаемый бюджет питания.

MaxBudget

Значение в единицах ватт, указывающее максимальный поддерживаемый бюджет питания.

ModelNumber[PMI_NAME_MAX]

Строка Юникода, содержащая номер модели счетчика питания, завершающаяся значением NULL.

SerialNumber[PMI_NAME_MAX]

Строка Юникода, содержащая серийный номер счетчика питания, завершающая значение NULL.

OEMInformation[PMI_NAME_MAX]

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

Замечания

Структура PMI_REPORTED_CAPABILITIES содержит следующие сведения о счетчике питания:

Возможности измерения счетчика электроэнергии.
Возможности бюджета счетчика электроэнергии, в том числе возможность изменения конфигурации бюджета.
Сведения о ресурсах счетчика питания. Эта информация определяется изготовителем оборудования для счетчика электроэнергии.

Структура PMI_REPORTED_CAPABILITIES возвращается с помощью запроса IOCTL_PMI_GET_CAPABILITIES управления ввода-вывода (IOCTL). Входные данные для этого запроса задаются значением перечислителя PMI_CAPABILITIES_TYPEPmiReportedCapabilities..

Если запрос завершится успешно, запрос возвращает PMI_CAPABILITIES структуру. Элемент возможностей этой структуры форматируется как структура PMI_REPORTED_CAPABILITIES.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно в Windows 7, Windows Server 2008 R2 и более поздних версиях операционных систем Windows.
заголовка	pmi.h (include Pmi.h)