IPowerNotify::P owerChangeNotify-Methode (portcls.h)
Die PowerChangeNotify-Methode benachrichtigt den Miniporttreiber über Änderungen im Energiezustand.
Syntax
void PowerChangeNotify(
[in] POWER_STATE PowerState
);
Parameter
[in] PowerState
Gibt den aktuellen Energiestatus an. Dieser Parameter ist eine Vereinigung vom Typ POWER_STATE. Der neue Energiezustand (PowerState.DeviceState) kann einer der DEVICE_POWER_STATE Enumerationswerte sein, die in IAdapterPowerManagement::P owerChangeStateaufgeführt sind.
Rückgabewert
Nichts
Bemerkungen
Der PortCls-Systemtreiber ruft die PowerChangeNotify-Methode des Miniporttreibers auf, um sie über Änderungen im Energiezustand zu benachrichtigen. Der Zweck dieses Aufrufs besteht darin, dem Miniporttreiber die Möglichkeit zu geben, jeden hardwarespezifischen Kontext direkt vor dem Einschalten zu speichern oder einen zuvor gespeicherten Kontext direkt nach dem Einschalten wiederherzustellen.
Der Miniporttreiber kann während des PowerChangeNotify-Anrufs in die Hardwareregister oder den Onboard-Speicher schreiben. Wenn das System herunterschaltet (einen Zustandsübergang von PowerDeviceD0 entfernt), ruft der PortCls-Systemtreiber PowerChangeNotify auf, bevor es IAdapterPowerManagement::P owerChangeState- und nach dem Anhalten aller aktiven Audiodatenströme aufruft. Dadurch erhält der Miniporttreiber die Möglichkeit, alle hardwarespezifischen Gerätekontexte zu speichern, bevor das Gerät herunter geht. Beispielsweise muss ein WavePci Miniport-Treiber möglicherweise seine DMA-Register speichern, wenn die Stromversorgung während einer Folge von Punkt-/Erfassungsdatenübertragungen auftritt. Wenn das System einschaltet (einen Zustandsübergang in Richtung PowerDeviceD0) macht, ruft PortCls PowerChangeNotify auf, nachdem es PowerChangeState- und vor dem Neustart angehaltener Audiodatenströme aufruft. Dadurch erhält der Miniporttreiber die Möglichkeit, einen zuvor gespeicherten Kontext wiederherzustellen, nachdem das Gerät eingeschaltet wurde.
Der Code für diese Methode muss sich im ausgelagerten Speicher befinden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Universal |
| Header- | portcls.h (include Portcls.h) |