NdisMCmCloseAddressFamilyComplete-Makro (ndis.h)

Artikel
02/29/2024

NdisMCmCloseAddressFamilyComplete gibt die letzte status der Clientanforderung zurück, für die der MCM-Treiber NDIS_STATUS_PENDING zurückgegeben hat, um den AF zu schließen.

Syntax

void NdisMCmCloseAddressFamilyComplete(
   _S_,
   _H_
);

Parameter

_S_

Der Aufrufer legt dies auf NDIS_STATUS_SUCCESS fest.

_H_

Gibt den von NDIS bereitgestellten Handle an, der an die ProtocolCmOpenAf-Funktion des MCM-Treibers übergeben wird, als dieser Client die Adressfamilie ursprünglich geöffnet hat.

Rückgabewert

Keine

Bemerkungen

Ein MCM-Treiber muss NdisMCmCloseAddressFamilyComplete aufrufen, wenn seine ProtocolCmCloseAf-Funktion zuvor NDIS_STATUS_PENDING für die angegebene NdisAfHandle zurückgegeben hat. Der Client, der den pended close-AF-Vorgang mit einem Aufruf von NdisClCloseAddressFamily initiiert hat, kann die zugewiesenen Ressourcen zum Nachverfolgen der Kommunikation über den AF erst dann freigeben, wenn der MCM-Treiber NdisMCmCloseAddressFamilyComplete aufruft.

Ein Aufruf von NdisMCmCloseAddressFamilyComplete bewirkt, dass NDIS den Client aufruft. ProtocolClCloseAfComplete-Funktion .

Der MCM-Treiber kann anschließend nicht die NdisAfHandle verwenden, die für den MCM-Treiber ungültig ist, wenn NdisMCmCloseAddressFamilyComplete die Steuerung zurückgibt.

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

Anforderungen

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