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

Статья
02/07/2025

Структура PMI_CAPABILITIES содержит сведения о возможностях измерения электроэнергии и бюджетирования счетчика электроэнергии.

Синтаксис

typedef struct _PMI_CAPABILITIES {
  ULONG                 Version;
  ULONG                 Size;
  PMI_CAPABILITIES_TYPE CapabilityType;
  union {
    PMI_REPORTED_CAPABILITIES        ReportedCapabilities;
    PMI_METERED_HARDWARE_INFORMATION MeteredHardwareInformation;
  } Capabilities;
} PMI_CAPABILITIES, *PPMI_CAPABILITIES;

Члены

Version

Значение, указывающее версию этой структуры. Для Windows 7, Windows Server 2008 R2 и более поздних версий Windows это значение должно быть 1.

Size

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

CapabilityType

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

Capabilities

Объединение поддерживаемых структур возможностей интерфейса Power Meter (PMI). В зависимости от значения члена CapabilityType одна из следующих возможностей используется для ссылки на следующие структуры возможностей PMI:

Capabilities.ReportedCapabilities

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

Элемент возможностей содержит эту структуру, если для члена CapabilityType задано значение PmiMeteredHardware.

Capabilities.MeteredHardwareInformation

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

Сведения о ресурсах
Возможности измерения
Возможности питания и бюджета

Элемент возможностей содержит эту структуру, если для элемента CapabilityType задано значение PmiReportedCapabilities.

Замечания

Структура PMI_CAPABILITIES используется для запроса множества возможностей PMI, поддерживаемых счетчиком электроэнергии.

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

Если запрос IOCTL успешно завершен, запрос возвращает PMI_CAPABILITIES структуру. Возможности этой структуры содержат данные, отформатированные в виде запрошенной структуры возможностей PMI.

Например, если запрос IOCTL IOCTL_PMI_GET_CAPABILITIES выполняется с набором входных данных для PmiReportedCapabilities, а запрос завершается успешно, запрос возвращает структуру PMI_CAPABILITIES со своими членами, заданными следующими значениями:

Элемент CapabilitiesType имеет значение PmiReportedCapabilities.
Элемент возможностей содержит данные, отформатированные как структура PMI_REPORTED_CAPABILITIES.

Требования

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

См. также

IOCTL_PMI_GET_CAPABILITIES

PMI_CAPABILITIES_TYPE

PMI_METERED_HARDWARE_INFORMATION

PMI_REPORTED_CAPABILITIES

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