EVT_WDF_DEVICE_WAKE_FROM_SX_TRIGGERED Rückruffunktion (wdfdevice.h)

  • Artikel

[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

Weitere Informationen

EvtDeviceArmWakeFromSx

EvtDeviceDisarmWakeFromSx

EvtDeviceWakeFromS0Triggered