NdisCmNotifyCloseAddressFamily-Funktion (ndis.h)

Artikel
02/26/2024

Die Funktion NdisCmNotifyCloseAddressFamily benachrichtigt NDIS, dass ein Anruf-Manager die Bindung an einen zugrunde liegenden Miniportadapter aufhebt und dass alle zugeordneten CoNDIS-Clients die angegebene Adressfamilie (AF) schließen sollten.

Syntax

NDIS_STATUS NdisCmNotifyCloseAddressFamily(
  [in] NDIS_HANDLE NdisAfHandle
);

Parameter

[in] NdisAfHandle

Ein NDIS-Handle, das den AF identifiziert, der von NDIS geschlossen werden soll. NDIS hat dieses Handle für die ProtocolCmOpenAf-Funktion des Aufrufmanagers bereitgestellt.

Rückgabewert

NdisCmNotifyCloseAddressFamily kann eine der folgenden Rückgaben ausführen:

Rückgabecode	Beschreibung
NDIS_STATUS_SUCCESS	NDIS hat die Adressfamilie erfolgreich geschlossen.
NDIS_STATUS_PENDING	NDIS verarbeitet diese Anforderung asynchron und ruft den Anruf-Manager auf. ProtocolCmNotifyCloseAfComplete-Funktion , wenn der Schließenvorgang abgeschlossen ist.
NDIS_STATUS_XXX	NDIS konnte die Anforderung aus einem bestimmten NDIS- oder Clienttreibergrund nicht ausführen.

Hinweise

Eigenständige CoNDIS-Anrufmanager, die sich als NDIS-Protokolltreiber registrieren, indem sie die Die NdisRegisterProtocolDriver-Funktion kann die Funktion NdisCmNotifyCloseAddressFamily aufrufen. Miniport-Anrufmanager (MCMs) rufen stattdessen auf NdisMCmNotifyCloseAddressFamily-Funktion .

Um einen AF für eine Bindung zu schließen, sollte der eigenständige Anrufmanager NdisCmNotifyCloseAddressFamily von der aufrufen. ProtocolUnbindAdapterEx-Funktion . NDIS ruft dann auf ProtocolClNotifyCloseAf-Funktion des Clients, der den angegebenen AF geöffnet hat.

Wenn NdisCmNotifyCloseAddressFamily NDIS_STATUS_PENDING zurückgibt, ruft NDIS die des Anrufmanagers auf. ProtocolCmNotifyCloseAfComplete-Funktion , nachdem der Client den AF-Abschlussvorgang abgeschlossen hat.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt in NDIS 6.0 und höher.
Zielplattform	Desktop
Kopfzeile	ndis.h (include Ndis.h)
Bibliothek	Ndis.lib
IRQL	PASSIVE_LEVEL
DDI-Complianceregeln	Irql_CallManager_Function(ndis)