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
:
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 |