Share via


Interfaz IPowerNotify (portcls.h)

La IPowerNotify interfaz es una interfaz opcional que los controladores de minipuerto pueden exponer si requieren notificación anticipada de cambios de estado de energía inminentes. Para determinar si el controlador de minipuerto admite la IPowerNotify interfaz, el controlador de puerto llama al método QueryInterface del objeto del controlador de miniporte con REFIID IID_IPowerNotify. Los siguientes tipos de controladores de minipuerto pueden admitir IPowerNotify:

IMiniportWavePci

IMiniportWaveCíclico

IMiniportMidi

IMiniportDMus

IMiniportTopology

IPowerNotify hereda de la interfaz IUnknown .

La IPowerNotify interfaz proporciona un único método al que llama el controlador de puerto para notificar al controlador de minipuerto cuando se produce un cambio en el estado de energía.

Por ejemplo, cuando el sistema operativo indica a un dispositivo de audio de onda que vaya a un estado de suspensión, el controlador de puerto pausa las secuencias activas y, a continuación, llama a la devolución de llamada de notificación de energía para informar al controlador de miniporte del apagado inminente. A continuación, el controlador de minipuerto tiene la oportunidad de guardar cualquier contexto necesario antes de llamar al método PowerChangeState del adaptador.

El proceso se invierte cuando el dispositivo se enciende. PortCls llama primero al método PowerChangeState del adaptador para encender el adaptador. A continuación, el controlador de puerto llama a la devolución de llamada del controlador de miniporte para permitir que el controlador de miniporte restaure su contexto. Por último, el controlador de puerto anula las secuencias de audio activas en pausa previamente.

Para obtener más información, consulte Implementación de IPowerNotify.

Herencia

La interfaz IPowerNotify hereda de la interfaz IUnknown . IPowerNotify también tiene estos tipos de miembros:

Métodos

La interfaz IPowerNotify tiene estos métodos.

 
IPowerNotify::P owerChangeNotify

El método PowerChangeNotify notifica al controlador de minipuerto los cambios en el estado de energía.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado portcls.h