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. Es werden keine neuen Features zu UMDF 1 hinzugefügt, und es gibt eingeschränkte Unterstützung für UMDF 1 für neuere Versionen von Windows 10. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF-.]
Ein Treiber OnArmWakeFromSx- Ereignisrückruffunktionsarme (d. h. aktiviert) ein Gerät, sodass es ein Wakesignal auslösen kann, während er sich im Zustand eines Niederstromgeräts befindet. Das Wake-Signal bewirkt, dass das Gerät seinen Arbeitszustand (D0) und das System in den Arbeitszustand (S0) wechselt.
Syntax
HRESULT OnArmWakeFromSx(
[in] IWDFDevice *pWdfDevice
);
Parameter
[in] pWdfDevice
Ein Zeiger auf die IWDFDevice Schnittstelle des Geräteobjekts, das eines der Treibergeräte darstellt.
Rückgabewert
Wenn der Vorgang erfolgreich ist, muss die OnArmWakeFromSx- Rückruffunktion S_OK oder einen anderen Statuswert zurückgeben, für den SUCCEEDED(Status) TRUEist. Andernfalls muss ein Statuswert zurückgegeben werden, für den ERFOLGREICH(Status) FALSE-ist.
Wenn SUCCEEDED(status) gleich FALSE-ist, ruft das Framework die IPowerPolicyCallbackWakeFromSx::OnDisarmWakeFromSx Rückruffunktion auf. (Das Framework meldet keinen Gerätefehler beim PnP-Manager.)
Bemerkungen
Ihr Treiber muss eine OnArmWakeFromSx- Rückruffunktion bereitstellen, wenn der Treiber die IPowerPolicyCallbackWakeFromSx--Schnittstelle unterstützt.
Diese Rückruffunktion behandelt gerätespezifische Vorgänge, die es dem Gerät ermöglichen, ein externes Ereignis zu erkennen, das ein Wakesignal auf dem Bus auslöst. Der Kernelmodusbustreiber verarbeitet busspezifische Vorgänge, z. B. das Power Management Event (PME)-Signal des PCI-Buss.
Wenn ein Treiber eine OnArmWakeFromSx- Rückruffunktion registriert hat, ruft das Framework es auf, während sich das Gerät noch im D0-Gerätestromzustand befindet, bevor der Bustreiber den Energiezustand des Geräts verringert, aber nachdem das Framework eine Wait/Wake IRP im Namen des Treibers gesendet hat.
Der Prozess erfolgt in der folgenden Reihenfolge:
- Das Framework bestimmt, dass das System in einen Systemzustand mit niedriger Stromversorgung wechselt.
- Das Framework ruft die OnArmWakeFromSx- Rückruffunktion des Treibers auf.
- Das Framework fordert den Treiber auf, den Bus des Geräts zu senken, um 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, mit denen das Gerät ein Wakesignal auslösen kann.
Weitere Informationen zu dieser Rückruffunktion finden Sie unter Unterstützende 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 |
| Mindest-UMDF-Version | 1.9 |
| Header- | wudfddi.h (include Wudfddi.h) |
Siehe auch
IPowerPolicyCallbackWakeFromSx-