EVT_WDF_DEVICE_WAKE_FROM_S0_TRIGGERED Rückruffunktion (wdfdevice.h)
[Gilt für KMDF und UMDF]
Die EvtDeviceWakeFromS0Triggered-Ereignisrückruffunktion eines Treibers informiert den Treiber darüber, dass sein Gerät, das zuvor in einen Gerätezustand mit niedriger Leistung versetzt wurde, während der Systemstromzustand bei S0 blieb, möglicherweise ein Aktivierungssignal ausgelöst hat.
Syntax
EVT_WDF_DEVICE_WAKE_FROM_S0_TRIGGERED EvtWdfDeviceWakeFromS0Triggered;
void EvtWdfDeviceWakeFromS0Triggered(
[in] WDFDEVICE Device
)
{...}
Parameter
[in] Device
Ein Handle für ein Framework-Geräteobjekt.
Rückgabewert
Keine
Bemerkungen
Um eine EvtDeviceWakeFromS0Triggered-Rückruffunktion zu registrieren, muss ein Treiber WdfDeviceInitSetPowerPolicyEventCallbacks aufrufen.
Wenn der Treiber diesen Rückruf registriert hat, ruft das Framework ihn nach dem Aufruf der EvtDeviceD0Entry-Rückruffunktion des Treibers und vor dem Aufruf der Rückruffunktion EvtDeviceDisarmWakeFromS0 des Treibers auf.
Systemhardware (BIOSes, Motherboards, Busadapter) kann manchmal ein Aktivierungssignal abwerfen, bevor der Bustreiber es erkennt, obwohl das Signal das System aktiviert. In solchen Fällen wird die Rückruffunktion EvtDeviceWakeFromS0Triggered des Treibers nicht aufgerufen, obwohl das Gerät des Treibers ein Aktivierungssignal ausgelöst hat.
Einige Busse kombinieren Wake-Signale von mehreren Kindern. Wenn Ihr Gerät mit einem dieser Busse verbunden ist, muss die Rückruffunktion möglicherweise ermitteln, ob das aktuelle Gerät das Aktivierungssignal ausgelöst hat. Wenn Ihr Gerät einen Hardware-Latch bereitstellt, der den ausgelösten Zustand des Geräts speichert, empfiehlt es sich, diesen Zustand in der Rückruffunktion EvtDeviceDisarmWakeFromS0 des Treibers zu überprüfen, da dieser Rückruf immer aufgerufen wird, nachdem das Gerät wieder aktiviert wurde, auch wenn das Aktivierungssignal gelöscht wurde.
Weitere Informationen zu dieser Rückruffunktion finden Sie unter Unterstützung des Leerlauf-Herunterschaltens.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| KMDF-Mindestversion | 1.0 |
| UMDF-Mindestversion | 2.0 |
| Kopfzeile | wdfdevice.h (einschließen von Wdf.h) |
| IRQL | PASSIVE_LEVEL |