WdfInterruptWdmGetInterrupt-Funktion (wdfinterrupt.h)
[Gilt nur für KMDF]
Die WdfInterruptWdmGetInterrupt-Methode gibt einen Zeiger auf das WDM-Interruptobjekt zurück, das einem angegebenen Framework-Interruptobjekt zugeordnet ist.
Syntax
PKINTERRUPT WdfInterruptWdmGetInterrupt(
[in] WDFINTERRUPT Interrupt
);
Parameter
[in] Interrupt
Ein Handle für ein Framework-Interruptobjekt.
Rückgabewert
Die WdfInterruptWdmGetInterrupt-Methode gibt einen Zeiger auf eine KINTERRUPT-Struktur zurück. Diese Methode gibt NULL zurück, wenn sie aufgerufen wird, bevor die EvtInterruptEnable-Rückruffunktion des Treibers aufgerufen wird oder nachdem die EvtInterruptDisable-Rückruffunktion des Treibers zurückgegeben wird.
Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.
Hinweise
Der Zeiger, den die WdfInterruptWdmGetInterrupt-Methode zurückgibt, ist gültig, bis die EvtInterruptDisable-Rückruffunktion des Treibers zurückgibt.
Weitere Informationen zum Behandeln von Interrupts in frameworkbasierten Treibern finden Sie unter Behandeln von Hardwareunterbrechungen.
Beispiele
Im folgenden Codebeispiel wird ein Zeiger auf die KINTERRUPT-Struktur abgerufen, die einem angegebenen Framework-Interruptobjekt zugeordnet ist.
PKINTERRUPT wdmInterrupt;
wdmInterrupt = WdfInterruptWdmGetInterrupt(Interrupt);
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| KMDF-Mindestversion | 1.0 |
| Kopfzeile | wdfinterrupt.h (einschließen von Wdf.h) |
| Bibliothek | Wdf01000.sys (siehe Versionierung der Frameworkbibliothek.) |
| IRQL | <= DIRQL |
| DDI-Complianceregeln | DriverCreate(kmdf) |