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 Änderungen des Power-State erfordern. Um festzustellen, ob der Miniporttreiber die IPowerNotify Schnittstelle unterstützt, ruft der Porttreiber die QueryInterface-Methode des Miniporttreibers mit REFIID IID_IPowerNotifyauf. Die folgenden Miniporttreibertypen können IPowerNotifyunterstützen:
IPowerNotify erbt von der IUnknown Schnittstelle.
Die IPowerNotify-Schnittstelle stellt eine einzelne Methode bereit, die vom Porttreiber aufgerufen wird, um den Miniporttreiber zu benachrichtigen, wenn eine Änderung des Energiezustands auftritt.
Wenn das Betriebssystem beispielsweise ein Wave-Audiogerät angibt, in einen Energiesparzustand zu wechseln, hält der Porttreiber alle aktiven Datenströme an und ruft dann den Strombenachrichtigungsrückruf auf, um den Miniporttreiber über die ausstehende Stromversorgung zu informieren. Der Miniporttreiber hat dann die Möglichkeit, alle erforderlichen Kontexte zu speichern, bevor die PowerChangeState--Methode des Adapters aufgerufen wird.
Der Vorgang wird rückgängig gemacht, wenn das Gerät einschaltt. PortCls ruft zuerst die PowerChangeState Methode des Adapters auf, um den Adapter hochzuschalten. 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.
Erbschaft
Die IPowerNotify Schnittstelle erbt von der IUnknown Schnittstelle. IPowerNotify hat auch folgende Arten von Mitgliedern:
Methodik
Die IPowerNotify Schnittstelle hat diese Methoden.
|
IPowerNotify::P owerChangeNotify Die PowerChangeNotify-Methode benachrichtigt den Miniporttreiber über Änderungen im Energiezustand. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Fenster |
| Header- | portcls.h |