WdfInterruptDisable-Funktion (wdfinterrupt.h)
[Gilt für KMDF und UMDF]
Die WdfInterruptDisable-Methode deaktiviert einen angegebenen Geräte-Interrupt, indem die Rückruffunktion EvtInterruptDisable des Treibers aufgerufen wird.
Syntax
void WdfInterruptDisable(
[in] WDFINTERRUPT Interrupt
);
Parameter
[in] Interrupt
Ein Handle für ein Framework-Interruptobjekt.
Rückgabewert
Keine
Bemerkungen
Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.
Die meisten frameworkbasierten Treiber müssen WdfInterruptDisable nicht aufrufen, da das Framework die EvtInterruptDisable-Rückruffunktion des Treibers jedes Mal aufruft, wenn das Gerät seinen Arbeitszustand (D0) verlässt.
Bei Interruptobjekten auf passiver Ebene ruft das Framework WdfInterruptDisable unter PASSIVE_LEVEL auf.
Rufen Sie WdfInterruptDisable nicht aus einem beliebigen Threadkontext, z. B. einem Anforderungshandler, auf.
Weitere Informationen zum Behandeln von Interrupts in frameworkbasierten Treibern finden Sie unter Behandeln von Hardwareunterbrechungen.
Beispiele
Im folgenden Codebeispiel wird der Geräte-Interrupt deaktiviert, der einem angegebenen Interruptobjekt zugeordnet ist.
WdfInterruptDisable(Interrupt);
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 | PASSIVE_LEVEL |
DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |