Función de devolución de llamada PEPCALLBACKNOTIFYDPM (pep_x.h)
Un AcceptDeviceNotification rutina de devolución de llamada de eventos 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 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 a 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
El AcceptDeviceNotification rutina debe devolver TRUE si controla la notificación o FALSE si no lo hace.
Observaciones
Esta rutina la implementa el complemento de extensión de plataforma (PEP) para un dispositivo. El miembro AcceptDeviceNot ification de la estructura PEP_INFORMATION es un puntero a una rutina de AcceptDeviceNotification. El PEP llama a la rutina de PoFxRegisterPlugin o PoFxRegisterPluginEx para registrar la rutina de AcceptDeviceNotification de 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 identificadores de notificación 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 bien 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 en ellos. El PEP se debe negar a controlar (devolviendo FALSE) cada notificación que no reconoce.
Se puede llamar a la rutina AcceptDeviceNotification en IRQL <= DISPATCH_LEVEL. El IRQL en el que se llama a la rutina de AcceptAcpiNot ification 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 | Valor |
---|---|
cliente mínimo admitido | Se admite a partir de Windows 10. |
de la plataforma de destino de | Windows |
encabezado de | pep_x.h (incluya Pep_x.h) |
irQL | <= DISPATCH_LEVEL |