Función de devolución de llamada PEPCALLBACKNOTIFYDPM (pep_x.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 de 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 en ellos. El PEP debe rechazar (devolviendo FALSE) todas las notificaciones que no reconocen.

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 parámetro Notification especifica el tipo de notificación. 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	pep_x.h (incluya Pep_x.h)
IRQL	<= DISPATCH_LEVEL

Consulte también

PEP_INFORMATION

PoFxRegisterPlugin

PoFxRegisterPluginEx