MINIPORT_ENABLE_MESSAGE_INTERRUPT Rückruffunktion (ndis.h)

Artikel
02/07/2025

NDIS kann die MiniportEnableMessageInterrupt--Funktion eines Miniporttreibers aufrufen, um einen Nachrichtenunterbrechung zu Diagnose- und Problembehandlungszwecken zu aktivieren.

Hinweis Sie müssen die Funktion mithilfe des MINIPORT_ENABLE_MESSAGE_INTERRUPT Typs deklarieren. Weitere Informationen finden Sie im folgenden Abschnitt "Beispiele".

Syntax

MINIPORT_ENABLE_MESSAGE_INTERRUPT MiniportEnableMessageInterrupt;

void MiniportEnableMessageInterrupt(
  [in] NDIS_HANDLE MiniportInterruptContext,
  [in] ULONG MessageId
)
{...}

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.

[in] MessageId

Eine meldungs signalisierte Unterbrechung. MessageId- ist ein Index für den IO_INTERRUPT_MESSAGE_INFO_ENTRY Strukturen in einem IO_INTERRUPT_MESSAGE_INFO Struktur. NDIS übergibt einen Zeiger an die zugeordnete IO_INTERRUPT_MESSAGE_INFO Struktur an der MessageInfoTable Member, wenn der Treiber erfolgreich für MSI mit der funktion NdisMRegisterInterruptEx registriert wird.

Rückgabewert

Nichts

Bemerkungen

Ein Miniporttreiber muss eine MiniportEnableMessageInterrupt--Funktion bereitstellen, wenn der Treiber die NdisMRegisterInterruptEx--Funktion aufruft, um einen Interrupt zu registrieren.

Miniport-Treiber sollten einen Nachrichtenunterbruch deaktivieren und aktivieren, wie im MiniportMessageInterrupt- erläutert. MiniportMessageInterruptDpc Referenzseiten.

NDIS ruft die MiniportEnableMessageInterrupt- auf und MiniportDisableMessageInterrupt Funktionen zum Aktivieren und Deaktivieren eines Nachrichtenunterbruchs zu Diagnose- und Problembehandlungszwecken. In der Regel greifen MiniportEnableMessageInterrupt und MiniportDisableMessageInterrupt auf Miniporttreiberressourcen zu, die von den von den MiniportMessageInterrupt Funktion. Daher ruft NDIS diese Handler bei DIRQL auf.

beispiele für

Um eine MiniportEnableMessageInterrupt--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 MiniportEnableMessageInterrupt--Funktion zu definieren, die den Namen "MyEnableMessageInterrupt" hat, verwenden Sie den MINIPORT_ENABLE_MESSAGE_INTERRUPT Typ, wie in diesem Codebeispiel gezeigt:

MINIPORT_ENABLE_MESSAGE_INTERRUPT MyEnableMessageInterrupt;

Implementieren Sie dann Ihre Funktion wie folgt:

_Use_decl_annotations_
VOID
 MyEnableMessageInterrupt(
    __in  NDIS_HANDLE  MiniportInterruptContext,
    __in  ULONG  MessageId
    )
  {...}

Der MINIPORT_ENABLE_MESSAGE_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 Funktionstyp MINIPORT_ENABLE_MESSAGE_INTERRUPT 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-	DIRQL (siehe Abschnitt "Hinweise")