NdisMCmCloseCallComplete-Makro (ndis.h)

Artikel
08/07/2023

NdisMCmCloseCallComplete gibt die letzte status der Anforderung eines Clients zurück, für die der MCM-Treiber zuvor NDIS_STATUS_PENDING zurückgegeben hat, um einen Anruf abreißen zu können.

Syntax

void NdisMCmCloseCallComplete(
   _S_,
   _VH_,
   _PH_
);

Parameter

_S_

Gibt den endgültigen status der Anforderung des Clients an, dass der MCM-Treiber die Verbindung entweder NDIS_STATUS_SUCCESS oder einen vom Aufrufer bestimmten NDIS_STATUS_XXX außer NDIS_STATUS_PENDING schließt.

_VH_

Gibt das Handle für den Vc für den Aufruf an. Dieses Handle wurde von NDIS bereitgestellt, als die Vc ursprünglich erstellt wurde, sei es vom MCM-Treiber mit NdisMCmCreateVc oder als Eingabeparameter für seine ProtocolCoCreateVc-Funktion .

_PH_

Gibt entweder NULL an, wenn NdisVcHandle eine Punkt-zu-Punkt-VC darstellt, oder das Handle für die letzte verbleibende Partei in einer Mehrpunktverbindung, die der MCM-Treiber aus seinem parteispezifischen Zustand abgerufen hat, der durch den CallMgrPartyContext als Eingabeparameter an seine übergeben wird. ProtocolCmCloseCall-Funktion .

Rückgabewert

Keine

Bemerkungen

Wenn die ProtocolCmCloseCall-Funktion eines MCM-Treibers NDIS_STATUS_PENDING zurückgibt, muss sie anschließend NdisMCmCloseCallComplete aufrufen, um den Client und NDIS darüber zu informieren, dass der Versuch, die Verbindung zu unterbrechen, erfolgreich oder mit einem Fehler abgeschlossen wurde. Ein Aufruf von NdisMCmCloseCallComplete bewirkt, dass NDIS die ProtocolClCloseCallComplete-Funktion des Clients aufruft .

Wenn NDIS_STATUS_SUCCESS als Status übergeben wird, sollte der MCM-Treiber NdisVcHandle (und NdisPartyHandle, falls vorhanden) für Übertragungen über das Netzwerk als unbrauchbar betrachten, sobald er NdisMCmCloseCallComplete aufruft. Wenn der MCM-Treiber die VC ursprünglich erstellt hat, sollte er NdisMCmDeleteVc mit demselben NdisVcHandle aufrufen, den er gerade an NdisMCmCloseCallComplete übergeben hat. Wenn der Client diese Vc erstellt hat, kann der MCM-Treiber einen Aufruf seiner ProtocolCoDeleteVc-Funktion mit der
ProtocolVcContext, der den Status pro VC, in dem das selbe NdisVcHandle gespeichert wurde, als Eingabeparameter bezeichnet.

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

Anforderungen

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