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

Статья
02/07/2025

Структура PEP_REQUEST_COMPONENT_PERF_STATE содержит список изменений состояния производительности (P-state), запрошенных платформой управления питанием Windows (PoFx), а также сведения о состоянии обработки этих запросов подключаемым модулем расширения платформы (PEP).

Синтаксис

typedef struct _PEP_REQUEST_COMPONENT_PERF_STATE {
  [in]  PEPHANDLE                         DeviceHandle;
  [in]  ULONG                             Component;
  [out] BOOLEAN                           Completed;
  [out] BOOLEAN                           Succeeded;
  [in]  ULONG                             PerfRequestsCount;
  [in]  PPEP_COMPONENT_PERF_STATE_REQUEST PerfRequests;
} PEP_REQUEST_COMPONENT_PERF_STATE, *PPEP_REQUEST_COMPONENT_PERF_STATE;

Члены

[in] DeviceHandle

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

[in] Component

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

[out] Completed

Завершит ли PEP запрошенные изменения состояния P. Задайте значение TRUE, чтобы указать, что изменения состояния P выполняются синхронно. Задайте значение FALSE, чтобы указать, что запрошенные изменения состояния P ожидаются и будут завершены асинхронно рабочим потоком PEP. Дополнительные сведения см. в разделе "Примечания".

[out] Succeeded

Успешно ли выполнено запрошенное изменение состояния P. Задайте значение TRUE, если PEP успешно завершил все изменения состояния P, запрошенные в массиве PerfRequests. Установите значение FALSE, если PEP не удалось выполнить все запрошенные изменения состояния P, в этом случае P-состояния в оборудовании остались неизменными. Элемент успешно выполнено, используется только для синхронных изменений состояния P. Если peP задает значение Завершено значение FALSE, PoFx игнорирует значение в элементе Успешно.

[in] PerfRequestsCount

Количество изменений состояния P, запрошенных в массиве, на которое указывает элемент PerfRequests.

[in] PerfRequests

Указатель на массив PEP_COMPONENT_PERF_STATE_REQUEST структур. Каждый элемент в массиве задает новый уровень производительности для назначения набору состояний P. Число элементов массива указывается элементом PerfRequestsCount.

Замечания

Эта структура используется уведомлением PEP_DPM_REQUEST_COMPONENT_PERF_STATE. DeviceHandle, компонент , PerfRequestsCountи PerfRequests элементов структуры содержат входные значения, предоставляемые PoFx при отправке этого уведомления. Элементы Completed и Succeeded содержат выходные значения, которые PEP записывает в структуру в ответ на уведомление.

PEP может выполнять запрошенные изменения состояния P-состояния синхронно или асинхронно. PEP может задать для элемента Completed значение TRUE, чтобы указать, что все запросы в уведомлении PEP_DPM_REQUEST_COMPONENT_PERF_STATE были завершены синхронно, то есть перед возвратом из acceptDeviceNotification peP подпрограмме обратного вызова. Кроме того, PEP может задать Завершено значение FALSE, чтобы указать, что запросы будут завершены асинхронно. Чтобы завершить запросы асинхронно, PEP должен вызвать подпрограмму RequestWorker, чтобы сообщить PoFx о том, что PEP имеет рабочий запрос для отправки, и PoFx ответит, отправив PEP_DPM_WORK уведомление в PEP.

PoFx записывает запрошенные изменения состояния P в массив PerfRequests перед отправкой уведомления PEP_DPM_REQUEST_COMPONENT_PERF_STATE. Если PEP обрабатывает запрошенные изменения состояния P синхронно, содержимое массива PerfRequests остается допустимым только до тех пор, пока возврат не будет возвращен из подпрограммы обратного вызова AcceptDeviceNotification. Если запросы завершены асинхронно, содержимое массива остается допустимым, пока PEP не вызовет подпрограмму CompleteWork, чтобы уведомить PoFx о том, что PEP выполнил ожидающие запросы.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Поддерживается начиная с Windows 10.
заголовка	pep_x.h (include Pep_x.h)