WdfInterruptGetInfo-Funktion (wdfinterrupt.h)
[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) |