EVT_WDF_DEVICE_DISARM_WAKE_FROM_S0 Rückruffunktion (wdfdevice.h)
[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") |