MINIPORT_CO_DELETE_VC Rückruffunktion (ndis.h)

Artikel
08/07/2023

Die MiniportCoDeleteVc-Funktion ist für verbindungsorientierte Miniports erforderlich. MiniportCoDeleteVc gibt an, dass eine VC von NDIS abgerissen und gelöscht wird.

Hinweis Sie müssen die Funktion mit dem MINIPORT_CO_DELETE_VC-Typ deklarieren. Weitere Informationen finden Sie im folgenden Abschnitt Beispiele.

Syntax

MINIPORT_CO_DELETE_VC MiniportCoDeleteVc;

NDIS_STATUS MiniportCoDeleteVc(
  [in] NDIS_HANDLE MiniportVcContext
)
{...}

Parameter

[in] MiniportVcContext

Gibt das Handle für einen vom Miniporttreiber zugewiesenen Kontextbereich an, in dem der Miniporttreiber seinen VC-Status beibehält. Der Miniporttreiber hat dieses Handle über seine MiniportCoCreateVc-Funktion für NDIS bereitgestellt.

Rückgabewert

Rückgabecode	Beschreibung
NDIS_STATUS_SUCCESS	Gibt an, dass der Miniporttreiber erfolgreich alle Ressourcen freigegeben hat, die dieser VC zugeordnet sind.

Hinweise

MiniportCoDeleteVc muss als synchrone Funktion geschrieben werden und kann unter keinen Umständen NDIS_STATUS_PENDING zurückgeben, ohne einen systemweiten Fehler zu verursachen.

MiniportCoDeleteVc gibt alle Ressourcen frei, die pro VC zugeordnet und im Kontextbereich MiniportVcContext gespeichert sind. Der Miniporttreiber muss auch den MiniportVcContext freigeben, der in seiner MiniportCoCreateVc-Funktion zugeordnet ist.

Beispiele

Um eine MiniportCoDeleteVc-Funktion zu definieren, müssen Sie zunächst eine Funktionsdeklaration bereitstellen, die den Typ der von Ihnen definierten Funktion identifiziert. Windows stellt eine Reihe von Funktionstypen für Treiber bereit. Das Deklarieren einer Funktion mithilfe der Funktionstypen hilft der Codeanalyse für Treiber, der statischen Treiberüberprüfung (Static Driver Verifier , SDV) und anderen Überprüfungstools, Fehler zu finden, und es ist eine Anforderung zum Schreiben von Treibern für das Windows-Betriebssystem.

Um beispielsweise eine MiniportCoDeleteVc-Funktion mit dem Namen "MyCoDeleteVc" zu definieren, verwenden Sie den MINIPORT_CO_DELETE_VC-Typ , wie in diesem Codebeispiel gezeigt:

MINIPORT_CO_DELETE_VC MyCoDeleteVc;

Implementieren Sie dann Ihre Funktion wie folgt:

_Use_decl_annotations_
NDIS_STATUS
 MyCoDeleteVc(
    NDIS_HANDLE  MiniportVcContext
    )
  {...}

Der MINIPORT_CO_DELETE_VC Funktionstyp ist in der Headerdatei Ndis.h definiert. Um Fehler beim Ausführen der Codeanalysetools genauer zu identifizieren, fügen Sie der Funktionsdefinition die Use_decl_annotations Anmerkung hinzu. Die Use_decl_annotations Anmerkung stellt sicher, dass die Anmerkungen verwendet werden, die auf den MINIPORT_CO_DELETE_VC Funktionstyp in der Headerdatei angewendet 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_annotations finden Sie unter Verhalten von Funktionen mit Anmerkungen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt für NDIS 6.0- und NDIS 5.1-Treiber (siehe MiniportCoDeleteVc (NDIS 5.1)) in Windows Vista. Unterstützt für NDIS 5.1-Treiber (siehe MiniportCoDeleteVc (NDIS 5.1)) in Windows XP.
Zielplattform	Windows
Kopfzeile	ndis.h (einschließlich Ndis.h)
IRQL	<= DISPATCH_LEVEL

Weitere Informationen

MiniportCoCreateVc

Freigeben über