Partager via


Interface IPowerNotify (portcls.h)

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

IMiniportWavePci

IMiniportWaveCyclique

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 d’onde d’atteindre 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 la mise sous tension imminente. 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 est en cours d’alimentation. PortCls appelle d’abord la méthode PowerChangeState de l’adaptateur pour alimenter l’adaptateur. 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 annule 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 dispose également de ces types de membres :

Méthode

L’interface IPowerNotify a ces méthodes.

 
IPowerNotify ::P owerChangeNotify

La méthode PowerChangeNotify informe le pilote miniport des modifications apportées à l’état d’alimentation.

Exigences

Exigence Valeur
plateforme cible Windows
d’en-tête portcls.h