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

Статья
02/07/2025

Подпрограмма обратного вызова события AcceptProcessorNotification обрабатывает уведомления об управлении питанием процессора (PPM) из платформы управления питанием Windows (PoFx).

Синтаксис

PEPCALLBACKNOTIFYPPM Pepcallbacknotifyppm;

BOOLEAN Pepcallbacknotifyppm(
  [in]                PEPHANDLE Handle,
  [in]                ULONG Notification,
  [in, out, optional] PVOID Data
)
{...}

Параметры

[in] Handle

Дескриптор устройства для PEP для целевого процессора. Если значение NULL, уведомление не предназначено для конкретного процессора.

[in] Notification

Идентификатор уведомления PPM. Этот параметр указывает тип уведомления PPM, которое отправляет PoFx. Список идентификаторов уведомлений PPM см. в уведомлениях об управлении питанием процессора (PPM).

[in, out, optional] Data

Указатель на выделенную poFx структуру, содержащую входные и (или) выходные данные для этого уведомления. Тип этой структуры зависит от идентификатора уведомления, указанного уведомления. Список типов структур, определенных для различных идентификаторов уведомлений PPM, см. в уведомлениях об управлении питанием процессора (PPM).

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

Подпрограмма acceptProcessorNotification должна возвращать значение TRUE, если оно обрабатывает уведомление или FALSE, если оно не выполняется.

Замечания

Эта подпрограмма реализуется подключаемым модулем расширения платформы (PEP) для процессора. Элемент AcceptProcessorNotification структуры PEP_INFORMATION является указателем на подпрограмму AcceptProcessorNot ification. PEP вызывает PoFxRegisterPlugin или подпрограмму PoFxRegisterPluginEx для регистрации процедуры AcceptProcessorNot ification peP с помощью PoFx.

IRQL, при котором вызывается подпрограмма acceptProcessorNot ification PEP, зависит от типа отправленного уведомления. Контекст, в котором этот интерфейс вызывается, диапазоны от PASSIVE_LEVEL до HIGH_LEVEL с отключенными прерываниями. Дополнительные сведения об IRQL, по которому отправляется каждый тип уведомлений, см. на отдельных эталонных страницах в уведомлениях об управлении питанием процессора (PPM).

Требования

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

См. также

PEP_INFORMATION

PoFxRegisterPlugin

PoFxRegisterPluginEx

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