EVT_WDF_DEVICE_D0_ENTRY_POST_INTERRUPTS_ENABLED Rückruffunktion (wdfdevice.h)

  • Artikel

[Gilt für KMDF und UMDF]

Die Ereignisrückruffunktion EvtDeviceD0EntryPostInterruptsEnabled eines Treibers führt gerätespezifische Vorgänge aus, die erforderlich sind, nachdem der Treiber die Hardwareunterbrechungen des Geräts aktiviert hat.

Syntax

EVT_WDF_DEVICE_D0_ENTRY_POST_INTERRUPTS_ENABLED EvtWdfDeviceD0EntryPostInterruptsEnabled;

NTSTATUS EvtWdfDeviceD0EntryPostInterruptsEnabled(
  [in] WDFDEVICE Device,
  [in] WDF_POWER_DEVICE_STATE PreviousState
)
{...}

Parameter

[in] Device

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

[in] PreviousState

Ein WDF_POWER_DEVICE_STATE typisierter Enumerator, der den vorherigen Energiezustand des Geräts identifiziert.

Rückgabewert

Wenn für die Rückruffunktion EvtDeviceD0EntryPostInterruptsEnabled keine Fehler auftreten, muss sie STATUS_SUCCESS oder einen anderen status-Wert zurückgeben, für den NT_SUCCESS(status) gleich TRUE ist. Andernfalls muss ein status Wert zurückgegeben werden, für den NT_SUCCESS(status) gleich FALSE ist.

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

Hinweise

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

Die Rückruffunktion EvtDeviceD0EntryPostInterruptsEnabled wird unter IRQL = PASSIVE_LEVEL aufgerufen, nachdem die EvtInterruptEnable-Rückruffunktion des Treibers zurückgegeben wurde. Ein Treiber kann diese Funktion bereitstellen, wenn er gerätespezifische Vorgänge ausführen muss, nachdem er einen Interrupt aktiviert hat, wenn diese Vorgänge nicht unter IRQL = DIRQL in der EvtInterruptEnable-Rückruffunktion ausgeführt werden sollen. Sie sollten diese Rückruffunktion nicht auslagerungsfähig machen.

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

Weitere Informationen zur Behandlung 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

EvtDeviceD0ExitPreInterruptsDisabled