NdisMCoDeactivateVcComplete-Funktion (ndis.h)

Artikel
07.02.2025

NdisMCoDeactivateVcComplete benachrichtigt NDIS und den Anrufmanager, dass der Miniporttreiber die Verarbeitung einer CM-initiierten Deactivate-VC-Anforderung abgeschlossen hat, für die der Miniporttreiber zuvor NDIS_STATUS_PENDING zurückgegeben hat.

Syntax

void NdisMCoDeactivateVcComplete(
  [in] NDIS_STATUS Status,
  [in] NDIS_HANDLE NdisVcHandle
);

Parameter

[in] Status

Gibt den endgültigen Status des Deaktivierungs-VC-Vorgangs an, der mit Ausnahme von NDIS_STATUS_PENDING NDIS_STATUS_SUCCESS oder einem beliebigen NDIS_STATUS_ XXX sein kann.

[in] NdisVcHandle

Gibt den Handle an, der die VC identifiziert. Der Aufrufer hat dieses Handle aus dem status pro VC abgerufen, der vom MiniportVcContext als Eingabeparameter an seine MiniportCoDeactivateVc Funktion.

Rückgabewert

Nichts

Bemerkungen

Ein verbindungsorientierter Miniporttreiber muss NdisMCoDeactivateVcComplete- aufrufen, wenn die MiniportCoDeactivateVc-Funktion zuvor NDIS_STATUS_PENDING als Reaktion auf eine Anforderung zurückgegeben hat, die vc zu deaktivieren, die durch die angegebene NdisVcHandle identifiziert wurde. Der Anrufmanager, der die VC-Deaktivierung mit einem Aufruf von NdisCmDeactivateVcinitiiert hat, kann NDIS oder dessen Client nicht benachrichtigen, ob Übertragungen auf dem VC deaktiviert wurden, bis der Miniporttreiber NdisMCoDeactivateVcCompleteaufruft.

Bevor ein VC deaktiviert wird, muss der Miniporttreiber alle ausstehenden Übertragungen auf dem VC abschließen. Das heißt, der Miniporttreiber muss alle ausstehenden Empfangs- und Übertragungen aller ausstehenden Sendedaten angeben, bevor NdisMCoDeactivateVcCompleteaufgerufen wird.

Ein Aufruf von NdisMCoDeactivateVcComplete bewirkt, dass NDIS die ProtocolCmDeactivateVcComplete Funktion des Anruf-Managers, der ursprünglich die VC-Deaktivierung angefordert hat. Nach dem Aufruf von NdisMCoDeactivateVcCompletekann der Miniporttreiber weder Empfangen noch Übertragungen an die VC angeben.

Anforderungen

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