EVT_WDF_DEVICE_WAKE_FROM_SX_TRIGGERED Rückruffunktion (wdfdevice.h)

Artikel
02/07/2025

[Gilt für KMDF und UMDF]

Die EvtDeviceWakeFromSxTriggered Ereignisrückruffunktion eines Treibers informiert den Treiber darüber, dass das Gerät, das zuvor einen Energiesparzustand eingegeben hatte, weil die Systemleistung reduziert wurde, möglicherweise ein Wake-Signal ausgelöst hat.

Syntax

EVT_WDF_DEVICE_WAKE_FROM_SX_TRIGGERED EvtWdfDeviceWakeFromSxTriggered;

void EvtWdfDeviceWakeFromSxTriggered(
  [in] WDFDEVICE Device
)
{...}

Parameter

[in] Device

Ein Handle zu einem Framework-Geräteobjekt.

Rückgabewert

Nichts

Bemerkungen

Um eine EvtDeviceWakeFromSxTriggered Rückruffunktion zu registrieren, muss ein Treiber WdfDeviceInitSetPowerPolicyEventCallbacksaufrufen.

Wenn der Treiber diesen Rückruf registriert hat, ruft es das Framework nach dem Aufrufen der EvtDeviceD0Entry- Rückruffunktion des Treibers und vor dem Aufrufen der EvtDeviceDisarmWakeFromSx Rückruffunktion des Treibers auf.

Systemhardware (BIOSes, Motherboards, Busadapter) kann manchmal ein Wakesignal ablegen, bevor der Bustreiber es erkennt, auch wenn das Signal das System aufwacht. In solchen Fällen wird die EvtDeviceWakeFromSxTriggered Rückruffunktion nicht aufgerufen, obwohl das Gerät des Treibers ein Wakesignal 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 Wake-up-Signal ausgelöst hat. Wenn Ihr Gerät einen Hardware-Riegel bereitstellt, der den ausgelösten Zustand des Geräts speichert, empfiehlt es sich, diesen Zustand im EvtDeviceDisarmWakeFromSx Rückruffunktion zu überprüfen, da dieser Rückruf immer aufgerufen wird, nachdem das Gerät aktiviert wurde, auch wenn das Wakesignal verworfen wurde.

Weitere Informationen zu dieser Rückruffunktion finden Sie unter Unterstützende System Wake-Up-.