EVT_WDF_DEVICE_WAKE_FROM_SX_TRIGGERED Rückruffunktion (wdfdevice.h)
[Gilt für KMDF und UMDF]
Die EvtDeviceWakeFromSxTriggered-Ereignisrückruffunktion eines Treibers informiert den Treiber darüber, dass sein Gerät, das zuvor aufgrund einer geringeren Systemleistung in den Gerätezustand versetzt wurde, möglicherweise ein Aktivierungssignal ausgelöst hat.
Syntax
EVT_WDF_DEVICE_WAKE_FROM_SX_TRIGGERED EvtWdfDeviceWakeFromSxTriggered;
void EvtWdfDeviceWakeFromSxTriggered(
[in] WDFDEVICE Device
)
{...}
Parameter
[in] Device
Ein Handle für ein Framework-Geräteobjekt.
Rückgabewert
Keine
Bemerkungen
Um eine EvtDeviceWakeFromSxTriggered-Rückruffunktion zu registrieren, muss ein Treiber WdfDeviceInitSetPowerPolicyEventCallbacks aufrufen.
Wenn der Treiber diesen Rückruf registriert hat, ruft das Framework ihn auf, nachdem die Rückruffunktion EvtDeviceD0Entry des Treibers und vor dem Aufruf der Rückruffunktion EvtDeviceDisarmWakeFromSx des Treibers aufgerufen wurde.
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 EvtDeviceWakeFromSxTriggered 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 EvtDeviceDisarmWakeFromSx 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ützen der Systemreaktivierung.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| KMDF-Mindestversion | 1.0 |
| UMDF-Mindestversion | 2.0 |
| Kopfzeile | wdfdevice.h (einschließen von Wdf.h) |
| IRQL | PASSIVE_LEVEL |