Функция обратного вызова PEPCALLBACKBACKNOTIFYDPM (pepfx.h)
Подпрограмма обратного вызова событий AcceptDeviceNotification обрабатывает уведомления об управлении питанием устройств (DPM) из платформы управления питанием Windows power management (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 подпрограмму для регистрации peP AcceptDeviceNotification подпрограмме PoFx.
PoFx вызывает эту подпрограмму для отправки уведомления DPM в PEP. В этом вызове параметр уведомления указывает тип уведомления, а параметр Data указывает на структуру данных типа, связанного с этим уведомлением. Список идентификаторов уведомлений DPM и связанных с ними типов структур см. в уведомлениях об управлении питанием устройств (DPM).
Уведомления DPM сообщают PEP о различных событиях уровня системы, устройства или компонента или передают запросы от драйвера устройства в PEP.
AcceptDeviceNotification подпрограмме не требуется принимать каждый запрос от драйвера устройства, например, он может игнорировать подсказки для размещения бездействия. Однако PEP должен понимать и принимать большинство уведомлений об управлении питанием устройств, даже если PEP решит не действовать над ними. PEP должен отказаться обрабатывать (возвращая FALSE) каждое уведомление, которое оно не распознает.
Подпрограмма acceptDeviceNotification может вызываться в IRQL <= DISPATCH_LEVEL. IRQL, при котором вызывается процедура peP AcceptAcpiNotification, зависит от типа отправленного уведомления. Тип уведомления указывается параметром уведомления. Дополнительные сведения см. на отдельных справочных страницах в уведомлениях об управлении питанием устройств (DPM).
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Поддерживается начиная с Windows 10. |
| целевая платформа | Виндоус |
| заголовка | pepfx.h (include Pep_x.h) |
| IRQL | <= DISPATCH_LEVEL |