Compartilhar via


Interface IPowerNotify (portcls.h)

A IPowerNotify interface é uma interface opcional que os drivers de miniporto podem expor se precisarem de notificação antecipada de alterações iminentes de estado de energia. Para determinar se o driver de miniporto dá suporte à IPowerNotify interface , o driver de porta chama o método QueryInterface do objeto de driver de miniport com REFIID IID_IPowerNotify. Os seguintes tipos de driver de miniport podem dar suporte IPowerNotifya :

IMiniportWavePci

IMiniportWaveCyclic

IMiniportMidi

IMiniportDMus

IMiniportTopology

IPowerNotify herda da interface IUnknown .

A IPowerNotify interface fornece um único método que o driver de porta chama para notificar o driver de miniporto quando ocorre uma alteração no estado de energia.

Por exemplo, quando o sistema operacional informa a um dispositivo de áudio de onda para ir para um estado de suspensão, o driver de porta pausa todos os fluxos ativos e, em seguida, chama o retorno de chamada de notificação de energia para informar o driver de miniporto da desligar iminente. Em seguida, o driver de miniporto tem a oportunidade de salvar qualquer contexto necessário antes que o método PowerChangeState do adaptador seja chamado.

O processo é invertido quando o dispositivo está sendo ligado. PortCls primeiro chama o método PowerChangeState do adaptador para ligar o adaptador. Em seguida, o driver de porta chama o retorno de chamada do driver de miniporto para permitir que o driver de miniporto restaure seu contexto. Por fim, o driver de porta desativa todos os fluxos de áudio ativos pausados anteriormente.

Para obter mais informações, consulte Implementando IPowerNotify.

Herança

A interface IPowerNotify herda da interface IUnknown . IPowerNotify também tem estes tipos de membros:

Métodos

A interface IPowerNotify tem esses métodos.

 
IPowerNotify::P owerChangeNotify

O método PowerChangeNotify notifica o driver de miniporto de alterações no estado de energia.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho portcls.h