Unterstützung von System Wake-Up in UMDF-Treibern

Warnung

UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. UMDF 1 werden keine neuen Features hinzugefügt, und die Unterstützung für UMDF 1 für neuere Versionen von Windows 10 ist eingeschränkt. Universelle Windows-Treiber müssen UMDF 2 verwenden.

Die archivierten UMDF 1-Beispiele finden Sie im Windows 11, Version 22H2 – Mai 2022 Treiberbeispiele Update.

Weitere Informationen finden Sie unter Erste Schritte mit UMDF.

Während sich das System in einem Energiesparzustand befindet, können einige Geräte ein externes Ereignis, z. B. ein eingehendes Netzwerkpaket, erkennen und das System dann reaktivieren. Wenn ein PCI-Gerät beispielsweise über eine Systemreaktivierungsfunktion verfügt, wie im PMC-Register (Power Management Capabilities) des Geräts angegeben, wird das System aktiviert, indem es das PME-Signal (Power Management Event) auf dem PCI-Bus auslöst.

Wenn Ihr Gerät das System aus einem systemweiten Low-Power-Zustand reaktivieren kann, muss die Rückruffunktion IDriverEntry::OnDeviceAdd im Besitzer der Energierichtlinie die folgenden beiden Schritte ausführen:

1. Rufen Sie IWDFDevice2::AssignSxWakeSettings auf, um Folgendes anzugeben:

   • Der Zustand mit geringer Leistung, in den das Gerät eintritt
   • Ob Benutzer die Einstellungen im Leerlauf des Geräts steuern können
   • Gibt an, ob die Aktivierungsfunktion des Geräts aktiviert oder deaktiviert ist

2. Implementieren Sie die IPowerPolicyCallbackWakeFromSx-Schnittstelle und die folgenden Ereignisrückruffunktionen, wenn Sie sie für Ihr Gerät benötigen:

   • IPowerPolicyCallbackWakeFromSx::OnArmWakeFromSx, mit dem die Gerätehardware auf ein externes Aktivierungsereignis reagieren kann.
   • IPowerPolicyCallbackWakeFromSx::OnDisarmWakeFromSx deaktiviert die Fähigkeit des Geräts, auf ein externes Aktivierungsereignis zu reagieren.
   • IPowerPolicyCallbackWakeFromSx::OnWakeFromSxTriggered, das den Treiber informiert, dass der Bus ein Aktivierungssignal erkannt hat.

Busfahrer beteiligen sich auch an der Aktivierung des Systems. Der Kernelmodustreiber für den Bus des Geräts tut alles, was auf dem Busadapter erforderlich ist, um die Fähigkeit eines Geräts zu aktivieren und zu deaktivieren, aus einem Zustand mit geringer Leistung zu reaktivieren.

Informationen zu Registrierungseinträgen, die die Aktivierungsfunktionen eines Geräts steuern, finden Sie unter Benutzersteuerung des Geräteleidle- und Reaktivverhaltens in UMDF.