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

Статья
02/29/2024

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

Синтаксис

PEPCALLBACKNOTIFYDPM Pepcallbacknotifydpm;

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

Параметры

[in] Notification

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

[in, out, optional] Data

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

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

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

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

PoFx вызывает эту подпрограмму для отправки уведомления DPM в PEP. В этом вызове параметр Notification указывает тип уведомления, а параметр Data указывает на структуру данных типа, связанного с этим уведомлением. Список идентификаторов уведомлений DPM и связанных с ними типов структуры см. в разделе Уведомления об управлении питанием устройств (DPM).

Уведомления DPM информируют PEP о различных событиях на уровне системы, устройства или компонента или передают запросы от драйвера устройства в PEP.

Подпрограмме AcceptDeviceNotification не требуется принимать все запросы от драйвера устройства, например, она может игнорировать указания места бездействия. Однако PEP должен понимать и принимать большинство уведомлений об управлении питанием устройств, даже если pep решит не действовать с ними. PeP должен отказаться обрабатывать (возвращая false) каждое уведомление, которое она не распознает.

Подпрограмму AcceptDeviceNotification можно вызвать по адресу IRQL <= DISPATCH_LEVEL. IrQL, в котором вызывается подпрограмма AcceptAcpiNotification pep, зависит от типа отправляемого уведомления. Тип уведомления задается параметром Notification . Дополнительные сведения см. на отдельных справочных страницах в разделе Уведомления об управлении питанием устройств (DPM).

Требования

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

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

PEP_INFORMATION

PoFxRegisterPlugin

PoFxRegisterPluginEx