EVT_WDF_DEVICE_WAKE_FROM_S0_TRIGGERED Rückruffunktion (wdfdevice.h)

2025-02-07

[Gilt für KMDF und UMDF]

Die EvtDeviceWakeFromS0Triggered Ereignisrückruffunktion informiert den Treiber darüber, dass das Gerät, das zuvor einen Gerätezustand mit niedriger Leistung eingegeben hatte, während der Systemstromzustand bei S0 blieb, möglicherweise ein Wakesignal ausgelöst hat.

Syntax

EVT_WDF_DEVICE_WAKE_FROM_S0_TRIGGERED EvtWdfDeviceWakeFromS0Triggered;

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

Parameter

[in] Device

Ein Handle zu einem Framework-Geräteobjekt.

Rückgabewert

Nichts

Bemerkungen

Um eine EvtDeviceWakeFromS0Triggered 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 EvtDeviceDisarmWakeFromS0 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 EvtDeviceWakeFromS0Triggered 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 Hardwareriegel bereitstellt, der den ausgelösten Zustand des Geräts speichert, empfiehlt es sich, diesen Zustand im EvtDeviceDisarmWakeFromS0 Rückruffunktion zu überprüfen, da dieser Rückruf immer nach dem Aufwachen des Geräts aufgerufen wird, auch wenn das Wakesignal gelöscht wurde.

Weitere Informationen zu dieser Rückruffunktion finden Sie unter Unterstützen von Power-Down-im Leerlauf.