EVT_WDF_DEVICE_DISARM_WAKE_FROM_S0 Rückruffunktion (wdfdevice.h)

  • Artikel

[Gilt für KMDF und UMDF]

Die EvtDeviceDisarmWakeFromS0-Ereignisrückruffunktion eines Treibers entwaffnet (d. min. deaktiviert) die Fähigkeit eines Geräts, ein Aktivierungssignal auszulösen, während sich ein Gerät in einem Gerätezustand mit geringem Stromverbrauch befindet, wenn das System im Betriebszustand des Systems (S0) verbleibt.

Syntax

EVT_WDF_DEVICE_DISARM_WAKE_FROM_S0 EvtWdfDeviceDisarmWakeFromS0;

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

Parameter

[in] Device

Ein Handle für ein Framework-Geräteobjekt.

Rückgabewert

Keine

Bemerkungen

Um eine EvtDeviceDisarmWakeFromS0-Rückruffunktion zu registrieren, muss ein Treiber WdfDeviceInitSetPowerPolicyEventCallbacks aufrufen. Der Treiber muss auch IdleCanWakeFromS0 im IdleCaps-Element seiner WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS-Struktur festlegen.

Wenn der Treiber eine EvtDeviceDisarmWakeFromS0-Rückruffunktion registriert hat, ruft das Framework diese auf, nachdem der Bustreiber festgestellt hat, dass ein Ereignis das Gerät aktiviert hat, und nachdem der Bustreiber anschließend die Warte-/Aktivierungs-IRP abgeschlossen hat. Vor dem Aufrufen der Rückruffunktion EvtDeviceDisarmWakeFromS0EvtDeviceDisarmWakeFromS0 ruft das Framework die Rückruffunktionen EvtDeviceD0Entry, EvtInterruptEnable und EvtDeviceWakeFromS0Triggered des Treibers auf.

Die Rückruffunktion EvtDeviceDisarmWakeFromS0 muss alle Hardwarevorgänge ausführen, die erforderlich sind, um die Fähigkeit des Geräts zu deaktivieren, ein Aktivierungssignal auszulösen, nachdem die Stromversorgung gesenkt wurde.

Weitere Informationen dazu, wann das Framework diese Rückruffunktion aufruft, finden Sie unter PnP- und Energieverwaltungsszenarien.

Weitere Informationen zu dieser Rückruffunktion finden Sie unter Unterstützung des Leerlauf-Herunterschaltens.

Die Rückruffunktion EvtDeviceDisarmWakeFromS0 wird unter IRQL = PASSIVE_LEVEL aufgerufen. Sie sollten diese Rückruffunktion nicht auslagerungsfähig machen.

Anforderungen

Anforderung Wert
Zielplattform Universell
KMDF-Mindestversion 1.0
UMDF-Mindestversion 2.0
Kopfzeile wdfdevice.h (einschließen von Wdf.h)
IRQL PASSIVE_LEVEL (siehe Abschnitt "Hinweise")

Weitere Informationen

EvtDeviceArmWakeFromS0

EvtDeviceDisarmWakeFromSx