NdisCloseAdapterEx-Funktion (ndis.h)

  • Artikel

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
NDIS_STATUS_SUCCESS
 NdisCloseAdapterEx hat die Bindung an den zugrunde liegenden Miniportadapter erfolgreich geschlossen.
NDIS_STATUS_PENDING
 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)

Weitere Informationen

NdisOpenAdapterEx

NdisUnbindAdapter

ProtocolBindAdapterEx

ProtocolCloseAdapterCompleteEx

ProtocolUnbindAdapterEx