EVT_WDF_DEVICE_D0_EXIT_PRE_INTERRUPTS_DISABLED Rückruffunktion (wdfdevice.h)
[Gilt für KMDF und UMDF]
Die EvtDeviceD0ExitPreInterruptsDisabled Ereignisrückruffunktion führt gerätespezifische Vorgänge aus, die erforderlich sind, bevor der Treiber die Hardwareunterbrechung 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 zu einem Framework-Geräteobjekt.
[in] TargetState
Ein WDF_POWER_DEVICE_STATE-typed-Enumerator, der den Gerätestromzustand angibt, den das Gerät eingibt.
Rückgabewert
Wenn die EvtDeviceD0ExitPreInterruptsDisabletsDisabled Rückruffunktion keine Fehler aufweist, muss sie STATUS_SUCCESS oder einen anderen Statuswert zurückgeben, für den NT_SUCCESS(Status) TRUEentspricht. Andernfalls muss ein Statuswert 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.
Bemerkungen
Um eine EvtDeviceD0ExitPreInterruptsDisabled Rückruffunktion zu registrieren, muss ein Treiber WdfDeviceInitSetPnpPowerEventCallbacksaufrufen.
Die EvtDeviceD0ExitPreInterruptsDisabled Rückruffunktion wird bei IRQL = PASSIVE_LEVEL aufgerufen, bevor das Framework die EvtInterruptDisable Rückruffunktion des Treibers aufruft. Ein Treiber kann diese Funktion bereitstellen, wenn sie gerätespezifische Vorgänge ausführen muss, bevor eine Unterbrechung deaktiviert wird, wenn diese Vorgänge bei IRQL = DIRQL in der EvtInterruptDisable Rückruffunktion nicht ausgeführt werden sollen.
Weitere Informationen dazu, wann das Framework diese Rückruffunktion aufruft, finden Sie unter PnP- und Power Management-Szenarien.
Weitere Informationen zum Behandeln von Unterbrechungen finden Sie unter Behandeln von Hardware-Interrupts.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Universal |
| Minimale KMDF-Version | 1.0 |
| Mindest-UMDF-Version | 2.0 |
| Header- | wdfdevice.h (einschließen Wdf.h) |
| IRQL- | PASSIVE_LEVEL (siehe Abschnitt "Hinweise") |