структура PEP_COMPONENT_PLATFORM_CONSTRAINTS (pep_x.h)

  • Статья

Структура PEP_COMPONENT_PLATFORM_CONSTRAINTS описывает состояние Fx с наименьшей энергопотреблением, в котором компонент может находиться, когда платформа находится в определенном состоянии простоя.

Синтаксис

typedef struct _PEP_COMPONENT_PLATFORM_CONSTRAINTS {
  [in] PEPHANDLE DeviceHandle;
  [in] ULONG     Component;
  [in] PULONG    MinimumFStates;
  [in] ULONG     PlatformStateCount;
} PEP_COMPONENT_PLATFORM_CONSTRAINTS, *PPEP_COMPONENT_PLATFORM_CONSTRAINTS;

Члены

[in] DeviceHandle

Значение PEPHANDLE, идентифицирующее устройство. Подключаемый модуль расширения платформы (PEP) предоставил этот дескриптор в ответ на предыдущее уведомление PEP_DPM_REGISTER_DEVICE .

[in] Component

Индекс, идентифицирующий компонент. Этот элемент является индексом массива Components в структуре PEP_DEVICE_REGISTER_V2 , которая ранее была предоставлена PEP в ответ на уведомление PEP_DPM_REGISTER_DEVICE для этого устройства. Если массив Components содержит N элементов, индексы компонентов варьируются от 0 до N–1.

[in] MinimumFStates

Указатель на выходной буфер. PEP записывает в этот буфер массив ULONG, который указывает состояние Fx с наименьшей мощностью, в котором компонент может находиться для каждого состояния простоя платформы. Элемент со значением 0 обозначает F0, значение 1 — F1 и т. д. Если платформа поддерживает состояния простоя M, элементы массива от 0 до M–1 указывают состояния Fx , соответствующие состояниям простоя платформы от 0 до M–1.

[in] PlatformStateCount

Количество элементов в массиве MinimumFStates . Массив содержит по одному элементу для каждого состояния простоя платформы. Платформа управления питанием Windows (PoFx) ранее отправляла уведомление о PEP_NOTIFY_PPM_QUERY_PLATFORM_STATES в PEP, чтобы определить количество поддерживаемых состояний простоя платформы.

Комментарии

Эта структура используется в уведомлении PEP_DPM_COMPONENT_IDLE_CONSTRAINTS . Все четыре элемента структуры содержат входные значения, которые PoFx предоставляет при отправке этого уведомления. PoFx выделяет буфер, на который указывает элемент MinimumFStates , и PEP выполняет запись в этот буфер в ответ на уведомление.

Требования

Требование Значение
Минимальная версия клиента Поддерживается начиная с Windows 10.
Верхняя часть pep_x.h (включая Pep_x.h)

См. также раздел

PEP_DEVICE_REGISTER_V2

PEP_DPM_COMPONENT_IDLE_CONSTRAINTS

PEP_DPM_REGISTER_DEVICE

PEP_NOTIFY_PPM_QUERY_PLATFORM_STATES