MINIPORT_CO_DELETE_VC Rückruffunktion (ndis.h)

Artikel
02/07/2025

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

Hinweis Sie müssen die Funktion mithilfe des MINIPORT_CO_DELETE_VC-Typs 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 den Handle für einen kontextbezogenen Miniporttreiberbereich an, in dem der Miniporttreiber den Zustand pro VC verwaltet. Der Miniporttreiber hat diesen Handle von der MiniportCoCreateVc--Funktion an NDIS geliefert.

Rückgabewert

Rückgabecode	Beschreibung
NDIS_STATUS_SUCCESS	Gibt an, dass der Miniporttreiber alle ressourcen für diese VC erfolgreich freigegeben hat.

Bemerkungen

MiniportCoDeleteVcmust als synchrone Funktion geschrieben werden und können unter keinen Umständen NDIS_STATUS_PENDING zurückgeben, ohne einen systemweiten Fehler zu verursachen.

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

beispiele für

Um eine MiniportCoDeleteVc--Funktion zu definieren, müssen Sie zuerst eine Funktionsdeklaration angeben, 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 MiniportCoDeleteVc--Funktion zu definieren, die den Namen "MyCoDeleteVc" hat, 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 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_CO_DELETE_VC 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 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-	Fenster
Header-	ndis.h (include Ndis.h)
IRQL-	<= DISPATCH_LEVEL

Siehe auch

MiniportCoCreateVc

Freigeben über