NdisCmDeactivateVc-Funktion (ndis.h)

Artikel
08/07/2023

NdisCmDeactivateVc benachrichtigt NDIS und den zugrunde liegenden Miniporttreiber, dass es keine weiteren Übertragungen für einen bestimmten aktiven Vc geben wird.

Syntax

NDIS_STATUS NdisCmDeactivateVc(
  [in] NDIS_HANDLE NdisVcHandle
);

Parameter

[in] NdisVcHandle

Gibt das Handle an, das den Nachweis identifiziert. Dieses Handle wurde von NDIS für den Anruf-Manager bereitgestellt, entweder, wenn NdisCoCreateVc für einen eingehenden Anruf aufgerufen wurde oder wenn seine ProtocolCoCreateVc-Funktion die Vc für einen vom Client initiierten ausgehenden Anruf eingerichtet hat.

Rückgabewert

Wenn NdisCmDeactivateVc etwas anderes als NDIS_STATUS_PENDING zurückgibt, sollte der Anrufmanager einen internen Aufruf an seine ProtocolCmDeactivateVcComplete-Funktion . Andernfalls ruft NDIS die Funktion ProtocolCmDeactivateVcComplete des CM auf, wenn dieser Vorgang abgeschlossen ist.

Hinweise

Ein eigenständiger Anruf-Manager ruft NdisCmDeactivateVc als wesentlichen Schritt beim Schließen eines Anrufs auf, in der Regel nach dem Paketaustausch mit Netzwerkkomponenten, der den Anruf abreißt.

Ein Aufruf von NdisCmDeactivateVc bewirkt, dass NDIS die MiniportCoDeactivateVc-Funktion des zugrunde liegenden Miniporttreibers aufruft, wodurch die aktuellen Aufrufparameter für Übertragungen auf dem Vc verworfen werden können, wodurch sie möglicherweise in vom Miniporttreiber festgelegten Standardwerte neu initialisiert werden. Wenn der Nachweis anschließend für einen anderen Aufruf reaktiviert wird, stellt der Client oder Anrufmanager dem Miniporttreiber neue Anrufparameter bereit.

Das an NdisCmDeactivateVc ÜbergebeneNdisVcHandle bleibt nach Abschluss der VC-Deaktivierung gültig. Die Deaktivierung eines beliebigen Vc ermöglicht es dem Ersteller, den Vc zur Wiederverwendung erneut zu initialisieren:

Nach der Vc-Deaktivierung und dem Schließen des Aufrufs kann ein Client einen ursprünglich erstellten Vc wiederverwenden, um einen weiteren Aufruf mit NdisClMakeCall zu tätigen.
Nach der Vc-Deaktivierung und dem Schließen des Aufrufs kann ein CM einen ursprünglich erstellten Nachweis wiederverwenden, um einen weiteren eingehenden Aufruf an denselben Client mit anzuzeigen. NdisCmDispatchIncomingCall.

Der Ersteller einer bestimmten Vc, die nicht wiederverwendet wird, ruft NdisCoDeleteVc auf, um diese VC zu zerstören.

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

Anforderungen

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