WdfInterruptGetInfo-Funktion (wdfinterrupt.h)

Artikel
02/27/2024

[Gilt für KMDF und UMDF]

Die WdfInterruptGetInfo-Methode ruft Informationen zu einem angegebenen Interrupt ab.

Syntax

void WdfInterruptGetInfo(
  [in]      WDFINTERRUPT        Interrupt,
  [in, out] PWDF_INTERRUPT_INFO Info
);

Parameter

[in] Interrupt

Ein Handle für das Interruptobjekt.

[in, out] Info

Ein Zeiger auf eine vom Aufrufer zugeordnete WDF_INTERRUPT_INFO-Struktur , die durch Aufrufen von WDF_INTERRUPT_INFO_INIT initialisiert wurde.

Rückgabewert

Keine

Bemerkungen

Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.

Die WdfInterruptGetInfo-Methode kann Interruptinformationen nur abrufen, wenn Ihr Treiber sie aufruft, nachdem das Framework die EvtDevicePrepareHardware-Rückruffunktion des Treibers aufgerufen hat und bevor das Framework die Rückruffunktion EvtDeviceReleaseHardware des Treibers aufgerufen hat.

Nachdem WdfInterruptGetInfo zurückgegeben wurde, kann der Treiber Interruptobjekte auf passiver Ebene identifizieren, indem er den Irql-Member der WDF_INTERRUPT_INFO-Struktur untersucht. Bei Interruptobjekten auf passiver Ebene ist dieser Wert PASSIVE_LEVEL.

Informationen zur Reihenfolge, in der die Rückruffunktionen eines Treibers aufgerufen werden, finden Sie unter PnP- und Energieverwaltungsszenarien.

Weitere Informationen zur Behandlung von Interrupts in frameworkbasierten Treibern finden Sie unter Behandeln von Hardwareunterbrechungen.

Beispiele

Im folgenden Codebeispiel wird eine WDF_INTERRUPT_INFO-Struktur initialisiert und WdfInterruptGetInfo aufgerufen.

WDF_INTERRUPT_INFO  Info;

WDF_INTERRUPT_INFO_INIT(&Info);
WdfInterruptGetInfo(
                    Interrupt,
                    &Info
                    );

Anforderungen

Anforderung	Wert
Zielplattform	Universell
KMDF-Mindestversion	1.0
UMDF-Mindestversion	2.0
Kopfzeile	wdfinterrupt.h (einschließen von Wdf.h)
Bibliothek	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<=DISPATCH_LEVEL
DDI-Complianceregeln	DriverCreate(kmdf)