Freigeben über

NdisCloseAdapter-Funktion (ndis.h)

  • Artikel

Hinweis NDIS 5. x ist veraltet und wird von NDIS 6 ersetzt. x. Informationen zur neuen NDIS-Treiberentwicklung finden Sie unter Netzwerktreiber ab Windows Vista. Informationen zum Portieren von NDIS 5. x Treiber auf NDIS 6. xfinden Sie unter Portieren von NDIS 5.x-Treibern zu NDIS 6.0.

NdisCloseAdapter gibt die bindung und die Ressourcen frei, die beim NdisOpenAdapterzugeordnet sind.

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 Close-Vorgangs zurückgibt, der einen der folgenden Werte sein 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

Nichts

Bemerkungen

Rückgabewert: Keine

Ein Protokolltreiber ruft in der Regel NdisCloseAdapter- aus der ProtocolUnbindAdapter--Funktion auf. Sie kann auch NdisCloseAdapter- aus der ProtocolBindAdapter--Funktion aufrufen, z. B. wenn ein OID-Wert nach dem Aufrufen NdisOpenAdapter- zum Einrichten einer Bindung nicht festgelegt werden konnte.

Sobald ein Protokoll NdisCloseAdapteraufruft, sollte das Handle bei NdisBindingHandle- vom Aufrufer als ungültig angesehen werden. Es handelt sich um einen Programmierfehler, um dieses Handle in einem nachfolgenden Aufruf einer NdisXxx--Funktion zu übergeben.

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

Anforderungen

Anforderung Wert
Header- ndis.h (include Ndis.h)
Library Ndis.lib
IRQL- PASSIVE_LEVEL

Siehe auch