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.
NDIS kann die MiniportEnableInterruptEx--Handlers eines Miniporttreibers aufrufen, um Unterbrechungen für Diagnose- und Problembehandlungszwecke zu aktivieren.
Hinweis Sie müssen die Funktion mithilfe des MINIPORT_ENABLE_INTERRUPT Typs deklarieren. Weitere Informationen finden Sie im folgenden Abschnitt "Beispiele".
Syntax
MINIPORT_ENABLE_INTERRUPT MiniportEnableInterrupt;
VOID MiniportEnableInterrupt(
[in] NDIS_HANDLE MiniportInterruptContext
)
{...}
Parameter
[in] MiniportInterruptContext
Ein Handle für einen Block von Kontextinformationen. Der Miniporttreiber hat diesen Handle im MiniportInterruptContext Parameter bereitgestellt, den der Miniporttreiber an den Funktion NdisMRegisterInterruptEx.
Rückgabewert
Nichts
Bemerkungen
Ein Miniporttreiber muss einen MiniportEnableInterruptEx--Handler bereitstellen, wenn der Treiber den NdisMRegisterInterruptEx--Funktion aufruft, um einen Interrupt zu registrieren.
Miniport-Treiber sollten Unterbrechungen deaktivieren und aktivieren, wie in den Referenzseiten MiniportInterrupt und MiniportInterruptDpc erläutert.
NDIS ruft die MiniportEnableInterruptEx- auf und MiniportDisableInterruptEx- Funktionen zum Aktivieren und Deaktivieren von Unterbrechungen für Diagnose- und Problembehandlungszwecke. In der Regel MiniportEnableInterruptEx und MiniportDisableInterruptEx auf Miniporttreiberressourcen zugreifen, die von der MiniportInterrupt--Funktion gemeinsam genutzt werden. Daher ruft NDIS diese Handler bei DIRQL auf.
beispiele für
Um eine MiniportEnableInterruptEx--Funktion zu definieren, müssen Sie zuerst eine Funktionsdeklaration bereitstellen, die den Typ der Funktion identifiziert, die Sie definieren. Windows stellt eine Reihe von Funktionstypen für Treiber bereit. Durch das Deklarieren einer Funktion mithilfe der Funktionstypen können Codeanalyse für Treiber, statische Treiberüberprüfung (SDV) und andere Überprüfungstools Fehler finden, und es ist eine Anforderung zum Schreiben von Treibern für das Windows-Betriebssystem.Um beispielsweise eine MiniportEnableInterruptEx--Funktion zu definieren, die den Namen "MyEnableInterruptEx" hat, verwenden Sie den MINIPORT_ENABLE_INTERRUPT Typ, wie in diesem Codebeispiel gezeigt:
MINIPORT_ENABLE_INTERRUPT MyEnableInterruptEx;
Implementieren Sie dann Ihre Funktion wie folgt:
_Use_decl_annotations_
VOID
MyEnableInterruptEx(
NDIS_HANDLE MiniportInterruptContext
)
{...}
Der MINIPORT_ENABLE_INTERRUPT Funktionstyp wird in der Ndis.h-Headerdatei definiert. Um Fehler genauer zu identifizieren, wenn Sie die Codeanalysetools ausführen, müssen Sie der Funktionsdefinition die Use_decl_annotations Anmerkung hinzufügen. Die Use_decl_annotations Anmerkung stellt sicher, dass die Anmerkungen, die auf den MINIPORT_ENABLE_INTERRUPT Funktionstyp in der Headerdatei angewendet werden, verwendet werden. Weitere Informationen zu den Anforderungen für Funktionsdeklarationen finden Sie unter Deklarieren von Funktionen mithilfe von Funktionsrollentypen für NDIS-Treiber.
Informationen zu Use_decl_annotationsfinden Sie unter Annotating Function Behavior.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Unterstützt in NDIS 6.0 und höher. |
| Zielplattform- | Fenster |
| Header- | ndis.h (include Ndis.h) |
| IRQL- | Siehe Abschnitt "Hinweise" |