IPowerNotify-Schnittstelle (portcls.h)
Die IPowerNotify
Schnittstelle ist eine optionale Schnittstelle, die Miniporttreiber verfügbar machen können, wenn sie eine vorherige Benachrichtigung über bevorstehende Energiezustandsänderungen benötigen. Um festzustellen, ob der Miniporttreiber die IPowerNotify
Schnittstelle unterstützt, ruft der Porttreiber die QueryInterface-Methode des Miniporttreiberobjekts mit REFIID IID_IPowerNotify auf. Die folgenden Miniporttreibertypen können unterstützt werden IPowerNotify
:
IPowerNotify
erbt von der IUnknown-Schnittstelle .
Die IPowerNotify
-Schnittstelle stellt eine einzelne Methode bereit, die der Porttreiber aufruft, um den Miniporttreiber zu benachrichtigen, wenn eine Änderung des Energiezustands auftritt.
Wenn das Betriebssystem z. B. ein Wave-Audiogerät anfordert, in einen Ruhezustand zu wechseln, hält der Porttreiber alle aktiven Streams an und ruft dann den Strombenachrichtigungsrückruf auf, um den Miniporttreiber über das bevorstehende Herunterfahren zu informieren. Der Miniporttreiber hat dann die Möglichkeit, jeden erforderlichen Kontext zu speichern, bevor die PowerChangeState-Methode des Adapters aufgerufen wird.
Der Prozess wird umgekehrt, wenn das Gerät aktiviert wird. PortCls ruft zuerst die PowerChangeState-Methode des Adapters auf, um den Adapter einzuschalten. Der Porttreiber ruft dann den Rückruf des Miniporttreibers auf, damit der Miniporttreiber seinen Kontext wiederherstellen kann. Schließlich hebt der Porttreiber alle zuvor angehaltenen aktiven Audiodatenströme auf.
Weitere Informationen finden Sie unter Implementieren von IPowerNotify.
Vererbung
Die IPowerNotify-Schnittstelle erbt von der IUnknown-Schnittstelle . IPowerNotify verfügt auch über folgende Arten von Membern:
Methoden
Die IPowerNotify-Schnittstelle verfügt über diese Methoden.
IPowerNotify::P owerChangeNotify Die PowerChangeNotify-Methode benachrichtigt den Miniporttreiber über Änderungen im Energiezustand. |
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform | Windows |
Kopfzeile | portcls.h |