Interface IPowerNotify (portcls.h)

L’interface IPowerNotify est une interface facultative que les pilotes miniport peuvent exposer s’ils nécessitent une notification préalable des changements d’état d’alimentation imminents. Pour déterminer si le pilote miniport prend en charge l’interface IPowerNotify , le pilote de port appelle la méthode QueryInterface de l’objet pilote miniport avec REFIID IID_IPowerNotify. Les types de pilotes miniport suivants peuvent prendre en charge IPowerNotify:

IMiniportWavePci

IMiniportWaveCyclic

IMiniportMidi

IMiniportDMus

IMiniportTopology

IPowerNotify hérite de l’interface IUnknown .

L’interface IPowerNotify fournit une méthode unique que le pilote de port appelle pour notifier le pilote miniport lorsqu’un changement d’état d’alimentation se produit.

Par exemple, lorsque le système d’exploitation indique à un périphérique audio wave de passer à un état de veille, le pilote de port interrompt tous les flux actifs, puis appelle le rappel de notification d’alimentation pour informer le pilote miniport de l’arrêt imminent de l’arrêt. Le pilote miniport a ensuite la possibilité d’enregistrer tout contexte nécessaire avant l’appel de la méthode PowerChangeState de l’adaptateur.

Le processus est inversé lorsque l’appareil s’allume. PortCls appelle d’abord la méthode PowerChangeState de l’adaptateur pour mettre l’adaptateur sous tension. Le pilote de port appelle ensuite le rappel du pilote miniport pour permettre au pilote miniport de restaurer son contexte. Enfin, le pilote de port désabuse tous les flux audio actifs précédemment suspendus.

Pour plus d’informations, consultez Implémentation d’IPowerNotify.

Héritage

L’interface IPowerNotify hérite de l’interface IUnknown. IPowerNotify a également les types de membres suivants :

Méthodes

L’interface IPowerNotify possède ces méthodes.

 
IPowerNotify ::P owerChangeNotify

La méthode PowerChangeNotify avertit le pilote miniport des modifications de l’état d’alimentation.

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête portcls.h