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

Статья
02/07/2025

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

Синтаксис

POFXCALLBACKUPDATEPLATFORMIDLESTATE Pofxcallbackupdateplatformidlestate;

NTSTATUS Pofxcallbackupdateplatformidlestate(
  [in] POHANDLE ProcessorHandle,
  [in] ULONG PlatformState,
  [in] PPEP_PLATFORM_IDLE_STATE_UPDATE Update
)
{...}

Параметры

[in] ProcessorHandle

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

[in] PlatformState

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

[in] Update

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

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

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

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

Замечания

Эта подпрограмма реализуется PoFx и вызывается PEP. Элемент UpdatePlatformIdleState структуры PEP_KERNEL_INFORMATION_STRUCT_V3 — это указатель на подпрограмму UpdatePlatformIdleStat e.

PEP должен дождаться завершения всех уведомлений PEP_NOTIFY_PPM_QUERY_PLATFORM_STATE, чтобы вызвать подпрограмму UpdatePlatformIdleState.

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

Требования

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

См. также

PEP_DPM_REGISTER_DEVICE

PEP_KERNEL_INFORMATION_STRUCT_V3

PEP_NOTIFY_PPM_QUERY_PLATFORM_STATE

PEP_NOTIFY_PPM_QUERY_PLATFORM_STATES

PEP_PLATFORM_IDLE_STATE_UPDATE

Поделиться через