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

  • Статья

Подпрограмма обратного вызова события 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, которая содержит входные и (или) выходные данные для этого уведомления. Тип этой структуры зависит от идентификатора уведомления, указанного параметром Notification. Список типов структур, определенных для различных идентификаторов уведомлений PPM, см. в разделе Уведомления об управлении питанием процессора (PPM).

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

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

Комментарии

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

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

Требования

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

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

PEP_INFORMATION

PoFxRegisterPlugin

PoFxRegisterPluginEx