NdisCloseAdapterEx-Funktion (ndis.h)
Ein Protokolltreiber ruft die NdisCloseAdapterEx-Funktion auf, um die Bindung und die Ressourcen freizugeben, die zugewiesen wurden, als der Treiber die NdisOpenAdapterEx-Funktion aufgerufen hat.
Syntax
NDIS_STATUS NdisCloseAdapterEx(
[in] NDIS_HANDLE NdisBindingHandle
);
Parameter
[in] NdisBindingHandle
Das Handle, das NDIS am NdisBindingHandle-Parameter von NdisOpenAdapterEx bereitgestellt hat. Dieses Handle identifiziert die Bindung, die NDIS schließen soll.
Rückgabewert
NdisCloseAdapterEx gibt einen der folgenden status Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
|
NdisCloseAdapterEx hat die Bindung an den zugrunde liegenden Miniportadapter erfolgreich geschlossen. |
|
NdisCloseAdapterEx hat den Schließenvorgang nicht abgeschlossen, und der Vorgang wird asynchron abgeschlossen. NDIS ruft den Protokolltreiber auf. ProtocolCloseAdapterCompleteEx-Funktion , wenn der Vorgang abgeschlossen ist. |
Hinweise
Ein Protokolltreiber ruft NdisCloseAdapterEx in der Regel von seinem ProtocolUnbindAdapterEx-Funktion . Der Treiber kann auch NdisCloseAdapterEx über seine ProtocolBindAdapterEx-Funktion aufrufen. Wenn der Treiber beispielsweise keinen OID-Wert nach dem Namen NdisOpenAdapterEx festlegen konnte, kann er NdisCloseAdapterEx über seine ProtocolBindAdapterEx-Funktion aufrufen.
Wenn ein Protokolltreiber einen Miniportadapter außerhalb des Kontexts von ProtocolUnbindAdapterEx oder ProtocolBindAdapterEx schließen muss, muss er die NdisUnbindAdapter-Funktion aufrufen.
Protokolltreiber sollten warten, bis alle gesendeten Anforderungen und OID-Anforderungen abgeschlossen werden, bevor sie NdisCloseAdapterEx aufrufen.
Sobald der Treiber NdisCloseAdapterEx aufruft, wird der von der NdisOpenAdapterEx-Funktion am Parameter NdisBindingHandle abgerufene Handle ungültig.
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 | PASSIVE_LEVEL |
| DDI-Complianceregeln | Irql_Protocol_Driver_Function(ndis) |