NdisMCmActivateVc-Funktion (ndis.h)

Artikel
02/07/2025

NdisMCmActivateVc benachrichtigt NDIS, dass ein MCM-Treiber bereit ist, Übertragungen auf eine bestimmte VC durchzuführen.

Syntax

NDIS_STATUS NdisMCmActivateVc(
  [in] NDIS_HANDLE         NdisVcHandle,
  [in] PCO_CALL_PARAMETERS CallParameters
);

Parameter

[in] NdisVcHandle

Gibt den Handle an, der die VC identifiziert.

[in] CallParameters

Zeigen Sie auf einen vom Aufrufer zugewiesenen Puffer, der als Struktur vom Typ CO_CALL_PARAMETERSformatiert ist und alle medienspezifischen Parameter enthält, die der Miniporttreiber für die aktivierte VC verwendet.

Rückgabewert

Wenn NdisMCmActivateVc alles andere als NDIS_STATUS_PENDING zurückgibt, sollte der MCM-Treiber einen internen Aufruf an seine ProtocolCmActivateVcComplete-Funktion. Andernfalls ruft NDIS die ProtocolCmActivateVcComplete-Funktion des MCM-Treibers auf, wenn dieser Vorgang abgeschlossen ist.

Bemerkungen

NdisMCmActivateVc informiert NDIS, dass ein MCM-Treiber Aufruf- und Medienparameter für eine neu erstellte VC eingerichtet oder die Aufrufparameter für eine etablierte VC geändert hat.

Ein MCM-Treiber muss NdisMCmActivateVc- aufrufen, nachdem eine Verbindung auf einem VC hergestellt wurde, aber bevor Daten auf dieser VC gesendet oder empfangen werden. Dieser Aufruf benachrichtigt NDIS, dass der Miniporttreiber eine NIC für Übertragungen auf dem VC vorbereitet hat.

Bei einem vom Client initiierten ausgehenden Anruf ruft ein MCM-Treiber in der Regel NdisMCmActivateVc nach dem Handshake an, der eine ausgehandelte Vereinbarung mit dem Remoteknoten oder eine erfolgreiche Anrufeinrichtung an der Switch angibt, bevor er NDIS (und den Client) über den Abschluss ausgehender Anrufe mit NdisMCmMakeCallCompletebenachrichtigt. Bei einem eingehenden Anruf ruft ein MCM-Treiber in der Regel NdisMCmActivateVc auf, nachdem er NdisMCmCreate Vc erfolgreich und vor dem Aufruf aufgerufen hat. NdisMCmDispatchIncomingCall.

Der Treiberschreiber bestimmt, ob ein MCM-Treiber über eine (interne) MiniportCoActivateVc--Funktion verfügt, die der Treiber im Kontext der Einrichtung von Verbindungen für ausgehende und eingehende Anrufe aufruft.

Für die Dauer der Verbindung kann ein MCM-Treiber die Anrufparameter als Bedingungen für die Netzwerkänderung ändern und/oder wenn der Client NdisClModifyCallQoSaufruft. Der MCM-Treiber muss den Zustand aktualisieren, den er über Aufrufparameter für die neuen Werte verwaltet, wenn er weiterhin Übertragungen auf dem VC gemäß den neu geänderten Aufrufparametern vornehmen kann. Sie muss NdisMCmActivateVc- aufrufen, um NDIS über Änderungen an den Aufrufparametern für die aktive VC zu benachrichtigen. Andernfalls kann der MCM-Treiber eine der folgenden Aktionen ausführen:

Rufen Sie NdisMCmDeactivateVc auf, nachdem die Anforderung des Clients fehlschlägt, QoS oder andere Anrufparameter für die VC so zu ändern, dass der Miniporttreiber keine Übertragungen auf der VC durchführen kann.
Stellen Sie die Aufrufparameter in einem zuvor akzeptierten Zustand wieder her, benachrichtigen Sie den Client, der die Änderung angefordert hat, und bleiben sie bereit, die Übertragung von Daten auf dem VC fortzusetzen. In diesem Fall hat der Client die Möglichkeit, die wiederhergestellten Aufrufparameter zu akzeptieren oder abzulehnen und eine Schließung der VC zu initiieren.

Nur verbindungsorientierte Miniporttreiber, die integrierte Anrufverwaltungsunterstützung bieten, können NdisMCmActivateVcanrufen. Eigenständige Anrufmanager, die sich bei NDIS als Protokolltreiber registrieren, rufen sie stattdessen NdisCmActivateVc- auf.

Anforderungen

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