NdisUnbindAdapter-Funktion (ndis.h)

  • Artikel

Protokolltreiber rufen die NdisUnbindAdapter-Funktion auf, um NDIS zum Schließen einer Bindung an einen zugrunde liegenden Miniportadapter anzufordern.

Syntax

NDIS_STATUS NdisUnbindAdapter(
  [in] NDIS_HANDLE NdisBindingHandle
);

Parameter

[in] NdisBindingHandle

Ein Handle, das der Protokolltreiber von einem Aufruf der NdisOpenAdapterEx-Funktion abgerufen hat. Das Handle identifiziert die zu schließende Bindung.

Rückgabewert

NdisUnbindAdapter gibt einen der folgenden status Werte zurück:

Rückgabecode Beschreibung
NDIS_STATUS_SUCCESS
 NdisUnbindAdapter hat den Vorgang zum Aufheben der Bindung erfolgreich initiiert.
NDIS_STATUS_RESOURCES
 Fehler bei NdisUnbindAdapter aufgrund unzureichender Ressourcen.

Hinweise

Protokolltreiber rufen NdisUnbindAdapter außerhalb des Kontexts der Funktionen ProtocolUnbindAdapterEx oder ProtocolBindAdapterEx auf. NDIS plant, dass ein Arbeitselement die ProtocolUnbindAdapterEx-Funktion des Protokolltreibers aufruft, und gibt sofort zurück.

Bevor der Aufruf von NdisUnbindAdapter zurückgibt, kann NDIS die Bindung bereits geschlossen haben. Daher darf der Aufrufer nach der Rückgabe des Aufrufs nicht davon ausgehen, dass das an den NdisBindingHandle-Parameter übergebene Handle weiterhin gültig ist.

Hinweis NDIS ruft ProtocolUnbindAdapterEx möglicherweise nicht auf, auch wenn NdisUnbindAdapter NDIS_STATUS_SUCCESS zurückgibt.
 

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Unterstützt in NDIS 6.0 und höher.
Zielplattform Desktop
Kopfzeile ndis.h (einschließlich Ndis.h)
Bibliothek Ndis.lib
IRQL <= DISPATCH_LEVEL
DDI-Complianceregeln Irql_Protocol_Driver_Function(ndis)

Weitere Informationen

NdisOpenAdapterEx

ProtocolBindAdapterEx

ProtocolUnbindAdapterEx