NdisMCmDeleteVc-Funktion (ndis.h)

Artikel
02/29/2024

NdisMCmDeleteVc zerstört eine vom Aufrufer erstellte VC.

Syntax

NDIS_STATUS NdisMCmDeleteVc(
  [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 NdisMCmCreateVc abgerufen.

Rückgabewert

NdisMCmDeleteVc kann eine der folgenden Aktionen zurückgeben:

Rückgabecode	Beschreibung
NDIS_STATUS_SUCCESS	NDIS hat die VC gelöscht.
NDIS_STATUS_NOT_ACCEPTED	Die VC ist weiterhin aktiv, sodass sie nicht gelöscht werden konnte.

Hinweise

Wenn ein MCM-Treiber NdisMCmDeleteVc aufruft, darf es keine ausstehenden Aufrufe für den angegebenen VC geben, und diese VC muss deaktiviert worden sein. Um diese Anforderungen zu erfüllen, bedeutet, dass der MCM-Treiber bereits NdisMCmDeactivateVc mit dem angegebenen NdisVcHandle erfolgreich aufgerufen hat.

Nur der Treiber, der eine bestimmte VC erstellt hat, kann diese VC löschen. Ein Aufruf von NdisMCmDeleteVc bewirkt, dass NDIS die ProtocolCoDeleteVc-Funktion des Clients aufruft, mit dem der Aufrufer NdisVcHandle gemeinsam verwendet .

Wenn NdisMCmDeleteVc das Steuerelement zurückgibt, ist NdisVcHandle nicht mehr gültig. Der MCM-Treiber kann die Ressourcen freigeben, die er zugewiesen hat, um den Zustand über die gelöschte VC beizubehalten, oder sie für die Wiederverwendung in einer nachfolgenden Benachrichtigung für eingehende Anrufe vorbereiten, nachdem er NdisMCmCreateVc aufgerufen hat.

Der Treiberschreiber bestimmt, ob ein MCM-Treiber über eine (interne) MiniportCoDeleteVc-Funktion verfügt, die der Treiber im Kontext des Abreißens von Verbindungen für ausgehende und eingehende Aufrufe aufruft.

Nur verbindungsorientierte Miniporttreiber, die integrierte Unterstützung für die Anrufverwaltung bieten, können NdisMCmDeleteVc aufrufen. Eigenständige Anrufmanager und -clients, die sich bei NDIS als Protokolltreiber registrieren, rufen stattdessen NdisCoDeleteVc auf.

Anforderungen

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