NdisUnbindAdapter-Funktion (ndis.h)
Protokolltreiber rufen die NdisUnbindAdapter--Funktion auf, um NDIS anzufordern, eine Bindung an einen zugrunde liegenden Miniportadapter zu schließen.
Syntax
NDIS_STATUS NdisUnbindAdapter(
[in] NDIS_HANDLE NdisBindingHandle
);
Parameter
[in] NdisBindingHandle
Ein Handle, das der Protokolltreiber von einem Aufruf der funktion NdisOpenAdapterEx abgerufen hat. Das Handle identifiziert die bindung, die geschlossen werden soll.
Rückgabewert
NdisUnbindAdapter einen der folgenden Statuswerte zurück:
| Rückgabecode | Beschreibung |
|---|---|
|
NdisUnbindAdapter den nicht gebundenen Vorgang erfolgreich initiiert. |
|
NdisUnbindAdapter aufgrund unzureichender Ressourcen nicht erfolgreich. |
Bemerkungen
Protokolltreiber rufen NdisUnbindAdapter außerhalb des Kontexts der funktionen ProtocolUnbindAdapterEx oder ProtocolBindAdapterEx auf. NDIS plant eine Arbeitsaufgabe, um die ProtocolUnbindAdapterEx--Funktion des Protokolltreibers aufzurufen und sofort zurückzugeben.
Bevor der Aufruf von NdisUnbindAdapter zurückgegeben wird, kann NDIS die Bindung bereits geschlossen haben. Daher darf der Aufrufer nach dem Zurückgeben des Aufrufs nicht davon ausgehen, dass der An den NdisBindingHandle Parameter übergebene Handle weiterhin gültig ist.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Unterstützt in NDIS 6.0 und höher. |
| Zielplattform- | Desktop |
| Header- | ndis.h (include Ndis.h) |
| Library | Ndis.lib |
| IRQL- | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | Irql_Protocol_Driver_Function(ndis) |