IPowerPolicyCallbackWakeFromSx::OnArmWakeFromSx-Methode (wudfddi.h)
[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. Weitere Informationen finden Sie unter Erste Schritte mit UMDF.]
Die OnArmWakeFromSx-Ereignisrückruffunktion eines Treibers (d. h. aktiviert) ein Gerät, sodass es ein Aktivierungssignal auslösen kann, während es sich in einem Gerätezustand mit geringer Leistung befindet. Das Aktivierungssignal bewirkt, dass das Gerät in seinen Arbeitszustand (D0) und das System in seinen Arbeitszustand (S0) wechselt.
Syntax
HRESULT OnArmWakeFromSx(
[in] IWDFDevice *pWdfDevice
);
Parameter
[in] pWdfDevice
Ein Zeiger auf die IWDFDevice-Schnittstelle des Geräteobjekts, das eines der Geräte des Treibers darstellt.
Rückgabewert
Wenn der Vorgang erfolgreich ist, muss die OnArmWakeFromSx-Rückruffunktion S_OK oder einen anderen status Wert zurückgeben, für den SUCCEEDED(status) true entspricht. Andernfalls muss ein status Wert zurückgegeben werden, für den SUCCEEDED(status) false entspricht.
Wenn SUCCEEDED(status) false entspricht, ruft das Framework die Rückruffunktion IPowerPolicyCallbackWakeFromSx::OnDisarmWakeFromSx des Treibers auf. (Das Framework meldet keinen Gerätefehler an den PnP-Manager.)
Hinweise
Ihr Treiber muss eine OnArmWakeFromSx-Rückruffunktion bereitstellen, wenn der Treiber die IPowerPolicyCallbackWakeFromSx-Schnittstelle unterstützt.
Diese Rückruffunktion verarbeitet gerätespezifische Vorgänge, die erforderlich sind, damit das Gerät ein externes Ereignis erkennen kann, das ein Aktivierungssignal auf dem Bus auslöst. Der Bustreiber im Kernelmodus verarbeitet busspezifische Vorgänge, z. B. das Aktivieren des PME-Signals (Power Management Event) des PCI-Busses.
Wenn ein Treiber eine OnArmWakeFromSx-Rückruffunktion registriert hat, ruft das Framework sie auf, während sich das Gerät noch im Gerätestromzustand D0 befindet, bevor der Bustreiber den Energiezustand des Geräts senkt, aber nachdem das Framework im Namen des Treibers eine Warte-/Reaktivierungs-IRP gesendet hat.
Der Prozess erfolgt in der folgenden Sequenz:
- Das Framework bestimmt, dass das System im Begriff ist, in einen Zustand des Low-Power-Systems zu gelangen.
- Das Framework ruft die OnArmWakeFromSx-Rückruffunktion des Treibers auf.
- Das Framework fordert den Treiber für den Bus des Geräts auf, die Leistung des Geräts zu senken.
Weitere Informationen dazu, wann das Framework diese Rückruffunktion aufruft, finden Sie unter PnP- und Power Management-Szenarien in UMDF.
Sie müssen keine OnArmWakeFromSx-Rückruffunktion bereitstellen, wenn Ihr Gerät keine speziellen Hardwarevorgänge erfordert, die es dem Gerät ermöglichen, ein Aktivierungssignal auszulösen.
Weitere Informationen zu dieser Rückruffunktion finden Sie unter Unterstützen von System-Wake-Up in UMDF-basierten Treibern.
Anforderungen
| Anforderung | Wert |
|---|---|
| Ende des Supports | In UMDF 2.0 und höher nicht verfügbar. |
| Zielplattform | Desktop |
| UMDF-Mindestversion | 1.9 |
| Kopfzeile | wudfddi.h (include Wudfddi.h) |
Weitere Informationen
IPowerPolicyCallbackWakeFromSx