Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
[Gilt für KMDF und UMDF]
Die WdfInterruptQueueWorkItemForIsr Methode stellt die EvtInterruptWorkItem Rückruffunktion für die Ausführung eines Framework-Interruptobjekts in die Warteschlange.
Syntax
BOOLEAN WdfInterruptQueueWorkItemForIsr(
[in] WDFINTERRUPT Interrupt
);
Die Parameter
[in] Interrupt
Ein Handle zu einem Framework-Interruptobjekt.
Rückgabewert
Wenn der ISR des Treibers bei IRQL = PASSIVE_LEVEL ausgeführt wird, gibt WdfInterruptQueueWorkItemForIsrTRUE- zurück, wenn es erfolgreich die EvtInterruptWorkItem Rückruffunktion des Interruptobjekts in die Warteschlange stellt. Die Methode gibt FALSE- zurück, wenn die Rückruffunktion zuvor in die Warteschlange gestellt wurde und nicht ausgeführt wurde.
Wenn der ISR des Treibers unter IRQL = DIRQL ausgeführt wird, stellt das Framework zunächst einen internen DPC in die Warteschlange und stellt dann eine Arbeitsaufgabe aus diesem DPC in die Warteschlange. In diesem Fall gibt WdfInterruptQueueWorkItemForIsrTRUE zurück, wenn das Framework erfolgreich den internen DPC in die Warteschlange stellt. Die Methode gibt FALSE- zurück, wenn der interne DPC zuvor in die Warteschlange gestellt wurde.
Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.
Bemerkungen
Treiber rufen in der Regel WdfInterruptQueueWorkItemForIsr aus einer EvtInterruptIsr- Rückruffunktion auf.
Die EvtInterruptWorkItem Rückruffunktion eines Interruptobjekts kann nur einmal in die Warteschlange gestellt werden, bevor es ausgeführt wird. Wenn daher ein Aufruf von WdfInterruptQueueWorkItemForIsr erfolgreich ist, werden nachfolgende Aufrufe keine zusätzlichen Rückrufe in die Warteschlange gestellt.
Weitere Informationen zum Behandeln von Unterbrechungen in frameworkbasierten Treibern finden Sie unter Behandeln von Hardware-Interrupts.
Eine Fehlerüberprüfung tritt auf, wenn Treiber WdfInterruptQueueWorkItemForIsr mit einem Interruptobjekt aufrufen, das keine EvtInterruptWorkItem- Rückruffunktion angibt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | universell |
| Minimale KMDF-Version | 1.11 |
| 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) |