NdisCmNotifyCloseAddressFamily-Funktion (ndis.h)
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 hat die Adressfamilie erfolgreich geschlossen. |
|
NDIS verarbeitet diese Anforderung asynchron und ruft den Anruf-Manager auf. ProtocolCmNotifyCloseAfComplete-Funktion , wenn der Schließenvorgang abgeschlossen ist. |
|
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) |