EVT_WDF_DEVICE_D0_EXIT_PRE_INTERRUPTS_DISABLED Rückruffunktion (wdfdevice.h)

  • Artikel

[Gilt für KMDF und UMDF]

Die EvtDeviceD0ExitPreInterruptsDisabled-Ereignisrückruffunktion eines Treibers führt gerätespezifische Vorgänge aus, die erforderlich sind, bevor der Treiber die Hardwareunterbrechungen des Geräts deaktiviert.

Syntax

EVT_WDF_DEVICE_D0_EXIT_PRE_INTERRUPTS_DISABLED EvtWdfDeviceD0ExitPreInterruptsDisabled;

NTSTATUS EvtWdfDeviceD0ExitPreInterruptsDisabled(
  [in] WDFDEVICE Device,
  [in] WDF_POWER_DEVICE_STATE TargetState
)
{...}

Parameter

[in] Device

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

[in] TargetState

Ein WDF_POWER_DEVICE_STATE typisiertes Enumerator, der den Geräteleistungszustand identifiziert, den das Gerät gerade eingeben wird.

Rückgabewert

Wenn die Rückruffunktion EvtDeviceD0ExitPreInterruptsDisabled keine Fehler aufweist, muss sie STATUS_SUCCESS oder einen anderen status Wert zurückgeben, für den NT_SUCCESS(status) true entspricht. Andernfalls muss ein status Wert zurückgegeben werden, für den NT_SUCCESS(status) false entspricht.

Weitere Informationen zu den Rückgabewerten dieser Rückruffunktion finden Sie unter Melden von Gerätefehlern.

Hinweise

Um eine EvtDeviceD0ExitPreInterruptsDisabled-Rückruffunktion zu registrieren, muss ein Treiber WdfDeviceInitSetPnpPowerEventCallbacks aufrufen.

Die Rückruffunktion EvtDeviceD0ExitPreInterruptsDisabled wird unter IRQL = PASSIVE_LEVEL aufgerufen, bevor das Framework die Rückruffunktion EvtInterruptDisable des Treibers aufruft. Ein Treiber kann diese Funktion bereitstellen, wenn er gerätespezifische Vorgänge ausführen muss, bevor er einen Interrupt deaktiviert, wenn diese Vorgänge nicht unter IRQL = DIRQL in der Rückruffunktion EvtInterruptDisable ausgeführt werden sollen.

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

Weitere Informationen zum Behandeln von Interrupts finden Sie unter Behandeln von Hardwareunterbrechungen.

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

EvtDeviceD0EntryPostInterruptsEnabled