Функция обратного вызова POFXCALLBACKUPDATEPROCESSORIDLESTATE (pep_x.h)

  • Статья

Подпрограмма UpdateProcessorIdleState вызывается подключаемым модулем расширения платформы (PEP) для обновления свойств указанного состояния простоя процессора.

Синтаксис

POFXCALLBACKUPDATEPROCESSORIDLESTATE Pofxcallbackupdateprocessoridlestate;

NTSTATUS Pofxcallbackupdateprocessoridlestate(
  [in] POHANDLE ProcessorHandle,
  [in] ULONG ProcessorState,
  [in] PPEP_PROCESSOR_IDLE_STATE_UPDATE Update
)
{...}

Параметры

[in] ProcessorHandle

Значение POHANDLE, представляющее регистрацию процессора (как устройства) с помощью платформы управления питанием Windows (PoFx). PEP ранее получил этот дескриптор от PoFx во время PEP_DPM_REGISTER_DEVICE уведомления, информирующего PEP о том, что процессор был зарегистрирован в PoFx.

[in] ProcessorState

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

[in] Update

Указатель на структуру PEP_PROCESSOR_IDLE_STATE_UPDATE , содержащую обновленные свойства состояния простоя процессора.

Возвращаемое значение

UpdateProcessorIdleState возвращает STATUS_SUCCESS, если он успешно обновляет свойства состояния простоя процессора. Возможные возвращаемые значения ошибок включают следующие коды состояния.

Возвращаемое значение Описание
STATUS_NOT_SUPPORTED
 Номер версии в структуре PEP_PROCESSOR_IDLE_STATE_UPDATE не поддерживается.
STATUS_NOT_IMPLEMENTED
 Подпрограмма UpdateProcessorIdleState не реализована для этого процессора.

Комментарии

Эта подпрограмма реализуется PoFx и вызывается PEP. Элемент UpdateProcessorIdleStateструктуры PEP_KERNEL_INFORMATION_STRUCT_V3 является указателем на подпрограмму UpdateProcessorIdleState .

Подпрограмма UpdateProcessorIdleState должна вызываться по адресу IRQL = PASSIVE_LEVEL.

Требования

Требование Значение
Минимальная версия клиента Поддерживается начиная с Windows 10.
Целевая платформа Windows
Header pep_x.h (включая Pep_x.h)
IRQL PASSIVE_LEVEL

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

PEP_DPM_REGISTER_DEVICE

PEP_KERNEL_INFORMATION_STRUCT_V3

PEP_PROCESSOR_IDLE_STATE_UPDATE