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

  • Статья

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

Синтаксис

typedef struct _PEP_PPM_IDLE_SELECT {
  [in]  PPEP_PROCESSOR_IDLE_CONSTRAINTS Constraints;
  [out] BOOLEAN                         AbortTransition;
  [out] ULONG                           IdleStateIndex;
  [out] ULONG                           DependencyArrayUsed;
  [in]  ULONG                           DependencyArrayCount;
  [in]  PPEP_PROCESSOR_IDLE_DEPENDENCY  DependencyArray;
  [out] ULONG                           PlatformIdleStateIndex;
} PEP_PPM_IDLE_SELECT, *PPEP_PPM_IDLE_SELECT;

Члены

[in] Constraints

Указатель на структуру PEP_PROCESSOR_IDLE_CONSTRAINTS , указывающую ограничения, которым должно соответствовать выбранное состояние простоя процессора. Операционная система задает значения в этой структуре. Подключаемый модуль расширения платформы (PEP) должен выбрать состояние простоя процессора, удовлетворяющее этим ограничениям.

[out] AbortTransition

Отмена ожидающего перехода в состояние простоя процессора. Установите для этого элемента значение TRUE, если PEP требует, чтобы операционная система отменила ожидающий переход, и значение FALSE в противном случае. PEP выбирает этот параметр, если требуется ставить работу в очередь и ядро Windows обрабатывает эту работу до того, как процессор перейдет в режим простоя.

[out] IdleStateIndex

Индекс, определяющий состояние простоя, в которое будет входить процессор. Этот элемент игнорируется, если AbortTransition = TRUE. Если процессор поддерживает N состояний простоя, индексы состояния простоя варьируются от 0 до N–1. PEP предоставил количество поддерживаемых состояний простоя для этого процессора в ответ на предыдущее уведомление PEP_NOTIFY_PPM_QUERY_IDLE_STATES .

[out] DependencyArrayUsed

Количество элементов массива, записанных PEP в выходной буфер, указывающее на член DependencyArray .

[in] DependencyArrayCount

Максимальное количество элементов в массиве, на который указывает элемент DependencyArray . Значение члена DependencyArrayCount равно значению MaximumCoordinatedProcessors , которое ранее было предоставлено PEP в ответ на уведомление PEP_NOTIFY_PPM_QUERY_IDLE_STATES .

[in] DependencyArray

Указатель на выходной буфер, в который PEP записывает массив PEP_PROCESSOR_IDLE_DEPENDENCY структур. Элементы этого массива указывают зависимости процессора в режиме простоя или зависимости пробуждения, которые должны быть выполнены для успешного перехода бездействия. PEP задает для элемента DependencyArrayUsed фактическое количество элементов массива, записываемых PEP в буфер. Выходной буфер выделяется платформой управления питанием Windows (PoFx) и гарантированно будет достаточно большим, чтобы содержать количество элементов массива, заданное членом DependencyArrayCount .

[out] PlatformIdleStateIndex

Индекс состояния простоя платформы, которое платформа будет вводить, когда процессор переходит в выбранное состояние простоя процессора. PEP должен задавать этот элемент, только если платформа переходит в состояние простоя одновременно с процессором. Этот член игнорируется, если значение AbortTransition имеет значение TRUE.

Комментарии

Эта структура используется уведомлением PEP_NOTIFY_PPM_IDLE_SELECT . Элементы Constraints, DependencyArrayCount и DependencyArray структуры содержат входные значения, предоставляемые PoFx при отправке этого уведомления. Остальные элементы содержат выходные значения, которые PEP записывает в структуру в ответ на уведомление.

Требования

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

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

PEP_NOTIFY_PPM_IDLE_SELECT

PEP_NOTIFY_PPM_QUERY_IDLE_STATES

PEP_PROCESSOR_IDLE_CONSTRAINTS

PEP_PROCESSOR_IDLE_DEPENDENCY