NdisMCoActivateVcComplete-Funktion (ndis.h)

Artikel
03/01/2024

NdisMCoActivateVcComplete benachrichtigt NDIS und den Anruf-Manager, dass der Miniporttreiber die Verarbeitung einer cm-initiierten activate-VC-Anforderung abgeschlossen hat, für die der Miniporttreiber zuvor NDIS_STATUS_PENDING zurückgegeben hat.

Syntax

void NdisMCoActivateVcComplete(
  [in] NDIS_STATUS         Status,
  [in] NDIS_HANDLE         NdisVcHandle,
  [in] PCO_CALL_PARAMETERS CallParameters
);

Parameter

[in] Status

Gibt die endgültige status des activate-VC-Vorgangs an, der NDIS_STATUS_SUCCESS oder ein beliebiger NDIS_STATUS_ XXX außer NDIS_STATUS_PENDING sein kann.

[in] NdisVcHandle

Gibt das Handle an, das den Nachweis identifiziert. Der Aufrufer hat dieses Handle aus seinem Pro-VC-Zustand abgerufen, der vom MiniportVcContext festgelegt wurde, der als Eingabeparameter an seine übergeben wurde. MiniportCoActivateVc-Funktion .

[in] CallParameters

Zeiger auf eine Struktur vom Typ CO_CALL_PARAMETERS, die vom Aufruf-Manager bereitgestellt wird und die Aufruf- und Medienparameter für die Aktivierung des Nachweises angibt.

Rückgabewert

Keine

Bemerkungen

Ein verbindungsorientierter Miniporttreiber muss NdisMCoActivateVcComplete aufrufen, wenn seine MiniportCoActivateVc-Funktion zuvor NDIS_STATUS_PENDING als Reaktion auf eine Anforderung zum Aktivieren oder Reaktivieren der vom angegebenen NdisVcHandle identifizierten Vc zurückgegeben hat. Der Anruf-Manager, der die Vc-Aktivierung mit einem Aufruf von NdisCmActivateVc initiiert hat, kann NDIS oder seinen Client nicht darüber benachrichtigen, ob Übertragungen auf dem Nachweis mithilfe der angegebenen Anrufparameter durchgeführt werden können, bis der Miniporttreiber NdisMCoActivateVcComplete aufruft.

Wenn der Miniporttreiber die von CM bereitgestellten Aufrufparameter für nicht akzeptabel hält, schlägt die VC-Aktivierung fehl, wenn er NdisMCoActivateVcComplete aufruft. Wenn die anfängliche Aktivierung eines Nachweises nicht ausgeführt wird, kann dies dazu führen, dass das Protokoll, das den Nachweis erstellt hat, ihn abreißt. Wenn der Miniporttreiber eine Anforderung zum Reaktivieren einer eingerichteten Vc mit neuen Aufrufparametern fehlschlägt, muss er die ursprünglichen Aufrufparameter wiederherstellen, die für diesen Vc eingerichtet wurden. Abhängig von der Art des Netzwerkmediums kann ein Miniporttreiber die Medienparameter ändern, wenn die Rundungs- und/oder Round-Down-Flags festgelegt sind, bevor NdisMCoActivateVcComplete aufgerufen wird.

Ein Aufruf von NdisMCoActivateVcComplete bewirkt, dass NDIS den aufruft. ProtocolCmActivateVcComplete-Funktion des Aufruf-Managers, der ursprünglich die Aktivierung des Nachweises angefordert hat.

Anforderungen

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

Weitere Informationen

ProtocolCmActivateVcComplete