NdisCloseAdapter-Funktion (ndis.h)

  • Artikel

Hinweis NDIS 5. x ist veraltet und wird durch NDIS 6 ersetzt. x. Informationen zur Entwicklung neuer NDIS-Treiber finden Sie unter Netzwerktreiber ab Windows Vista. Informationen zum Portieren von NDIS 5. x Treiber für NDIS 6. x, siehe Portieren von NDIS 5.x-Treibern zu NDIS 6.0.

NdisCloseAdapter gibt die festgelegte Bindung und die zugewiesenen Ressourcen frei, wenn das Protokoll NdisOpenAdapter genannt wurde.

Syntax

void NdisCloseAdapter(
  [out] PNDIS_STATUS Status,
  [in]  NDIS_HANDLE  NdisBindingHandle
);

Parameter

[out] Status

Zeiger auf eine vom Aufrufer bereitgestellte Variable, in der diese Funktion den status des Schließen-Vorgangs zurückgibt, wobei es sich um einen der folgenden Werte handeln kann:

  • NDIS_STATUS_SUCCESS
    Die Bindung wurde geschlossen, und alle Ressourcen, die sich auf diese Bindung beziehen, wurden freigegeben.

  • NDIS_STATUS_PENDING
    Eine Close-Adapter-Anforderung wird asynchron behandelt, und die ProtocolCloseAdapterComplete-Funktion des Aufrufers wird aufgerufen, wenn der Schließenvorgang abgeschlossen ist.

[in] NdisBindingHandle

Gibt den von NdisOpenAdapter zurückgegebenen Handle an, der den zu schließenden virtuellen Adapter oder die NIC identifiziert.

Rückgabewert

Keine

Bemerkungen

Rückgabewert: keiner

Ein Protokolltreiber ruft in der Regel NdisCloseAdapter über seine ProtocolUnbindAdapter-Funktion auf. Es kann auch NdisCloseAdapter über seine ProtocolBindAdapter-Funktion aufrufen, z. B. wenn nach dem Aufrufen von NdisOpenAdapter zum Einrichten einer Bindung kein OID-Wert festgelegt werden konnte.

Sobald ein Protokoll NdisCloseAdapter aufruft, sollte das Handle bei NdisBindingHandle vom Aufrufer als ungültig eingestuft werden. Es ist ein Programmierfehler, dieses Handle bei jedem nachfolgenden Aufruf einer NdisXxx-Funktion zu übergeben.

  • Zielplattform: Universell
  • Version: Nicht unterstützt für NDIS 6.0-Treiber in Windows Vista. Verwenden Sie stattdessen NdisCloseAdapterEx. Unterstützt für NDIS 5.1-Treiber in Windows Vista und Windows XP.

Anforderungen

Anforderung Wert
Header ndis.h (einschließlich Ndis.h)
Bibliothek Ndis.lib
IRQL PASSIVE_LEVEL

Weitere Informationen