NdisCloseAdapterEx-Funktion (ndis.h)
Ein Protokolltreiber ruft die NdisCloseAdapterEx--Funktion auf, um die Bindung und die Ressourcen freizugeben, die beim Aufrufen der NdisOpenAdapterEx--Funktion zugeordnet wurden.
Syntax
NDIS_STATUS NdisCloseAdapterEx(
[in] NDIS_HANDLE NdisBindingHandle
);
Parameter
[in] NdisBindingHandle
Das Handle, das NDIS an der NdisBindingHandle Parameter von NdisOpenAdapterExbereitgestellt. Mit diesem Handle wird die Bindung identifiziert, die NDIS schließen soll.
Rückgabewert
NdisCloseAdapterEx gibt einen der folgenden Statuswerte zurück:
| Rückgabecode | Beschreibung |
|---|---|
|
NdisCloseAdapterEx die Bindung an den zugrunde liegenden Miniportadapter erfolgreich geschlossen. |
|
NdisCloseAdapterEx den Schließvorgang nicht abgeschlossen und der Vorgang wird asynchron abgeschlossen. NDIS ruft die Protokolltreiber auf ProtocolCloseAdapterCompleteEx Funktion, wenn der Vorgang abgeschlossen ist. |
Bemerkungen
Ein Protokolltreiber ruft in der Regel NdisCloseAdapterEx- von seinem ProtocolUnbindAdapterEx--Funktion. Der Treiber kann auch NdisCloseAdapterEx- über die ProtocolBindAdapterEx--Funktion aufrufen. Wenn der Treiber beispielsweise nach dem Aufruf NdisOpenAdapterExeinen OID-Wert nicht festgelegt hat, kann er NdisCloseAdapterEx- aus seiner ProtocolBindAdapterEx--Funktion aufrufen.
Wenn ein Protokolltreiber einen Miniportadapter außerhalb des Kontexts von ProtocolUnbindAdapterEx oder ProtocolBindAdapterExschließen muss, muss er die NdisUnbindAdapter--Funktion aufrufen.
Protokolltreiber sollten auf alle Sendeanforderungen und OID-Anforderungen warten, die sie abgeschlossen haben, bevor sie NdisCloseAdapterExaufrufen.
Sobald der Treiber NdisCloseAdapterExaufruft, wird das von der NdisOpenAdapterEx-Funktion abgerufene Handle an der NdisBindingHandle Parameter ungültig.
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- | PASSIVE_LEVEL |
| DDI-Complianceregeln | Irql_Protocol_Driver_Function(ndis) |