Compartir a través de


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

Consulte también

PEP_INFORMATION

poFxRegisterPlugin

PoFxRegisterPluginEx