WdfInterruptGetDevice-Funktion (wdfinterrupt.h)

2025-03-22

[Gilt für KMDF und UMDF]

Die WdfInterruptGetDevice--Methode gibt ein Handle an das Framework-Geräteobjekt zurück, das einem angegebenen Framework-Interruptobjekt zugeordnet ist.

Syntax

WDFDEVICE WdfInterruptGetDevice(
  [in] WDFINTERRUPT Interrupt
);

Die Parameter

[in] Interrupt

Ein Handle zu einem Framework-Interruptobjekt.

Rückgabewert

WdfInterruptGetDevice ein Handle an ein Framework-Geräteobjekt zurückgibt.

Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.

Bemerkungen

Weitere Informationen zum Behandeln von Unterbrechungen in frameworkbasierten Treibern finden Sie unter Behandeln von Hardware-Interrupts.

Beispiele

Das folgende Codebeispiel zeigt, wie eine EvtInterruptIsr- Rückruffunktion einen Zeiger auf den treiberdefinierten Kontextbereich für das Geräteobjekt abrufen kann, zu dem ein Interruptobjekt gehört.

BOOLEAN
MyEvtInterruptIsr(
    IN WDFINTERRUPT Interrupt,
    IN ULONG  MessageID
    )
{
    PDEVICE_EXTENSION  devExt;

    devExt = GetMyDeviceContext(WdfInterruptGetDevice(Interrupt));
...
}

Anforderungen

Anforderung	Wert
Zielplattform	universell
Minimale KMDF-Version	1.0
Mindest-UMDF-Version	2.0
Kopfzeile	wdfinterrupt.h (einschließen Wdf.h)
Bibliothek	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<= DIRQL
DDI-Complianceregeln	DriverCreate(kmdf)

Siehe auch

EvtInterruptIsr