NdisCoDeleteVc-Funktion (ndis.h)

Artikel
08/07/2023

NdisCoDeleteVc zerstört eine vom Aufrufer erstellte VC.

Syntax

NDIS_STATUS NdisCoDeleteVc(
  [in] NDIS_HANDLE NdisVcHandle
);

Parameter

[in] NdisVcHandle

Gibt das Handle an, das den zu löschenden Nachweis identifiziert. Der Aufrufer hat dieses Handle ursprünglich von NdisCoCreateVc abgerufen.

Rückgabewert

NdisCoDeleteVc kann eine der folgenden Rückgaben:

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

Hinweise

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

Wenn der Abbruch des Aufrufs 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 Aufrufabbruch von einem Remoteclient initiiert wurde, hat der eigenständige Anruf-Manager bereits NdisCmDeactivateVc mit dem angegebenen NdisVcHandle aufgerufen, und seine Deaktivierungsanforderung wurde 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 Anruf-Managers aufruft, mit dem der Aufrufer NdisVcHandle teilt.

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

Eigenständige Anrufmanager, die sich bei NDIS als Protokolltreiber registrieren, können NdisCoDeleteVc aufrufen. Verbindungsorientierte Miniporttreiber, die integrierte Unterstützung für die Anrufverwaltung bieten, rufen stattdessen NdisMCmDeleteVc an.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (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
Kopfzeile	ndis.h (include Ndis.h)
Bibliothek	Ndis.lib
IRQL	<= DISPATCH_LEVEL
DDI-Complianceregeln	Irql_Connection_Function(ndis)