NdisCoDeleteVc-Funktion (ndis.h)

Artikel
02/07/2025

NdisCoDeleteVc zerstört eine vom Anrufer erstellte VC.

Syntax

NDIS_STATUS NdisCoDeleteVc(
  [in] NDIS_HANDLE NdisVcHandle
);

Parameter

[in] NdisVcHandle

Gibt den Handle an, der die zu löschende VC identifiziert. Der Aufrufer hat dieses Handle ursprünglich von NdisCoCreateVcabgerufen.

Rückgabewert

NdisCoDeleteVc- kann eine der folgenden Werte zurückgeben:

Rückgabecode	Beschreibung
NDIS_STATUS_SUCCESS	NDIS hat die VC gelöscht.
NDIS_STATUS_NOT_ACCEPTED	Der VC ist noch aktiv, sodass er nicht gelöscht werden konnte.
NDIS_STATUS_CLOSING	Dieser Aufruf ist redundant, aber die Deaktivierung für die angegebene VC steht noch aus.

Bemerkungen

Wenn ein Protokoll NdisCoDeleteVc-aufruft, darf es keine ausstehenden Aufrufe für die angegebene VC geben und diese VC bereits deaktiviert wurde. Um diese Anforderungen zu erfüllen, bedeutet dies, dass die folgenden Bedingungen gelten:

Wenn der Anrufabriss von einem lokalen Client initiiert wurde, hat dieser Client bereits NdisClCloseCall mit dem angegebenen NdisVcHandle- aufgerufen und seine Close-Call-Anforderung wurde erfolgreich abgeschlossen.
Wenn der Anrufabbruch von einem Remoteclient initiiert wurde, hat der eigenständige Anrufmanager bereits NdisCmDeactivateVc mit dem angegebenen NdisVcHandle aufgerufen und seine Deaktivierungsanforderung erfolgreich abgeschlossen.

Nur das Protokoll, das eine bestimmte VC erstellt hat, kann diese VC löschen. Ein Aufruf von NdisCoDeleteVc bewirkt, dass NDIS sowohl die MiniportCoDeleteVc-Funktion des zugrunde liegenden Miniporttreibers als auch die ProtocolCoDeleteVc--Funktion des Clients oder Anrufmanagers aufruft, mit der der Anrufer die NdisVcHandle teilt.

Wenn NdisCoDeleteVc Steuerelement zurückgibt, ist die NdisVcHandle- nicht mehr gültig.

Eigenständige Anrufmanager, die sich selbst bei NDIS als Protokolltreiber registrieren, können NdisCoDeleteVcaufrufen. Verbindungsorientierte Miniporttreiber, die stattdessen integrierte Call-Management-Supportanrufe NdisMCmDeleteVc bereitstellen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Unterstützt für NDIS 6.0- und NDIS 5.1-Treiber (siehe NdisCoDeleteVc (NDIS 5.1)) in Windows Vista. Unterstützt für NDIS 5.1-Treiber (siehe NdisCoDeleteVc (NDIS 5.1)) in Windows XP.
Zielplattform-	Desktop
Header-	ndis.h (include Ndis.h)
Library	Ndis.lib
IRQL-	<= DISPATCH_LEVEL
DDI-Complianceregeln	Irql_Connection_Function(ndis)