структура 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_QUERY_IDLE_STATES