Función de devolución de llamada PEPCALLBACKNOTIFYDPM (pepfx.h)
Una rutina de devolución de llamada de eventos AcceptDeviceNotification controla las notificaciones de administración de energía de dispositivos (DPM) del marco de administración de energía de Windows (PoFx).
Sintaxis
PEPCALLBACKNOTIFYDPM Pepcallbacknotifydpm;
BOOLEAN Pepcallbacknotifydpm(
[in] ULONG Notification,
[in, out, optional] PVOID Data
)
{...}
Parámetros
[in] Notification
Identificador de notificación de DPM. Este parámetro especifica el tipo de notificación de DPM que PoFx está enviando. Para obtener una lista de identificadores de notificación de DPM, consulte Notificaciones de administración de energía de dispositivos (DPM).
[in, out, optional] Data
Puntero a una estructura asignada por PoFx que contiene los datos de entrada o salida de esta notificación. El tipo de esta estructura depende del identificador de notificación especificado por Notification. Para obtener una lista de los tipos de estructura definidos para los distintos identificadores de notificación de DPM, consulte Notificaciones de administración de energía de dispositivos (DPM).
Valor devuelto
La rutina AcceptDeviceNotification debe devolver TRUE si controla la notificación o FALSE si no lo hace.
Comentarios
Esta rutina se implementa mediante el complemento de extensión de plataforma (PEP) para un dispositivo. El miembro AcceptDeviceNotification de la estructura PEP_INFORMATION es un puntero a una rutina AcceptDeviceNotification . El PEP llama a la rutina PoFxRegisterPlugin o PoFxRegisterPluginEx para registrar la rutina AcceptDeviceNotification del PEP con PoFx.
PoFx llama a esta rutina para enviar una notificación DPM al PEP. En esta llamada, el parámetro Notification especifica el tipo de notificación y el parámetro Data apunta a una estructura de datos del tipo asociado a esta notificación. Para obtener una lista de los identificadores de notificación de DPM y sus tipos de estructura asociados, consulte Notificaciones de administración de energía de dispositivos (DPM).
Las notificaciones DPM informan al PEP sobre varios eventos de nivel de sistema, dispositivo o componente o pasan solicitudes del controlador de dispositivo al PEP.
La rutina AcceptDeviceNotification no tiene que aceptar todas las solicitudes del controlador del dispositivo; por ejemplo, puede omitir las sugerencias de residencia inactivas. Sin embargo, el PEP debe comprender y aceptar la mayoría de las notificaciones de administración de energía de dispositivos, incluso si el PEP decide no actuar sobre ellos. El PEP debe negarse a controlar (devolviendo FALSE) cada notificación que no reconoce.
Se puede llamar a la rutina AcceptDeviceNotification en IRQL <= DISPATCH_LEVEL. La IRQL en la que se llama a la rutina AcceptAcpiNotification del PEP varía según el tipo de notificación que se envía. El tipo de notificación se especifica mediante el parámetro Notification . Para obtener más información, consulte las páginas de referencia individuales en Notificaciones de administración de energía de dispositivos (DPM).
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Se admite a partir de Windows 10. |
| Plataforma de destino | Windows |
| Encabezado | pepfx.h (include Pep_x.h) |
| IRQL | <= DISPATCH_LEVEL |