Partilhar via


Interface IPowerNotify (portcls.h)

A interface IPowerNotify é 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 à interface IPowerNotify, o driver de porta chama o método queryInterface do objeto de driver de miniporto com IID_IPowerNotifyREFIID. Os seguintes tipos de driver de miniport podem dar suporte a IPowerNotify:

IMiniportWavePci

IMiniportWaveCyclic

IMiniportMidi

IMiniportDMus

IMiniportTopology

IPowerNotify herda da interface IUnknown.

A interface IPowerNotify 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 queda de energia 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 habilitado. O PortCls primeiro chama o método PowerChangeState do adaptador para ativar 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 quaisquer fluxos de áudio ativos pausados anteriormente.

Para obter mais informações, consulte ImplementandoIPowerNotify.

Herança

A interface de IPowerNotify herda da interface IUnknown. iPowerNotify também tem esses 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
da Plataforma de Destino Windows
cabeçalho portcls.h