NdisUnbindAdapter-Funktion (ndis.h)
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 |
|---|---|
|
NdisUnbindAdapter hat den Vorgang zum Aufheben der Bindung erfolgreich initiiert. |
|
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.
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) |