OPEN_NDK_ADAPTER_HANDLER Rückruffunktion (ndisndk.h)

Artikel
02/07/2025

Die OpenNDKAdapterHandler (OPEN_NDK_ADAPTER_HANDLER) öffnet eine NDK-Adapterinstanz auf einem NDK-fähigen NDIS-Miniportadapter.

Syntax

OPEN_NDK_ADAPTER_HANDLER OpenNdkAdapterHandler;

NDIS_STATUS OpenNdkAdapterHandler(
  [in] NDIS_HANDLE MiniportAdapterContext,
  [in] PNDIS_OPEN_NDK_ADAPTER_PARAMETERS Parameters,
       NDK_ADAPTER **ppNdkAdapter
)
{...}

Parameter

[in] MiniportAdapterContext

Ein Handle zu einem Kontextbereich, den der Miniporttreiber in seiner MiniportInitializeEx--Funktion zugewiesen hat. Der Miniporttreiber verwendet diesen Kontextbereich, um Zustandsinformationen für einen NDIS-Miniportadapter beizubehalten.

[in] Parameters

Ein Zeiger auf eine NDIS_OPEN_NDK_ADAPTER_PARAMETERS-Struktur, die die Eingabeparameter definiert, um eine NDK_ADAPTER Instanz zu öffnen.

Die NDIS_OPEN_NDK_ADAPTER_PARAMETERS-Struktur muss die NDKPI-Hauptversion und die niedrigste NDKPI-Nebenversion angeben, die der NDK-Consumer unterstützen kann.

Wenn der Anbieter die vom Verbraucher angegebene Hauptversion nicht unterstützt, muss der Anbieter die Anforderung mit NDIS_STATUS_BAD_VERSION fehlschlagen.

Wenn der Anbieter die vom Verbraucher angegebene Hauptversion unterstützt und die angegebene Nebenversion kleiner oder gleich der höchsten Nebenversion ist, die der Anbieter unterstützt, muss der Anbieter die Anforderung erfolgreich ausführen und die höchste Nebenversion verwenden, die der Anbieter unterstützt.

Wenn der Consumer z. B. Version 1.0 anfordert und der Anbieter 1.1 unterstützt, muss der Anbieter Version 1.1 in den NDK_ADAPTER_INFO-Struktur- und NDK-Objektheadern melden.

Hinweis Höhere Nebenversionen beim Anbieter immer vollständig abwärtskompatibel mit niedrigeren Nebenversionen (d. h. einer Obermenge von) niedrigeren Nebenversionen.

Wenn der Anbieter die vom Verbraucher angegebene Hauptversion unterstützt und die angegebene Nebenversion größer als die höchste Nebenversion ist, die der Anbieter unterstützt, muss der Anbieter die Anforderung mit NDIS_STATUS_BAD_VERSION nicht bestehen.

ppNdkAdapter

Ein Zeiger auf eine Variable, die den Zeiger auf eine NDK_ADAPTER Struktur enthält. Im Gegenzug von OPEN_NDK_ADAPTER_HANDLERidentifiziert die NDK_ADAPTER Struktur, auf die von ppNdkAdapter verwiesen wird die neu geöffnete NDK-Adapterinstanz.

Rückgabewert

OPEN_NDK_ADAPTER_HANDLER können einen der folgenden Werte zurückgeben:

Rückgabecode	Beschreibung
NDIS_STATUS_SUCCESS	Die NDK-Adapterinstanz wurde erfolgreich geöffnet.
NDIS_STATUS_BAD_VERSION	Die angeforderte Versionsnummer wird nicht unterstützt.
NDIS_STATUS_ADAPTER_NOT_READY	Die NDK-Funktion des Miniportadapters ist nicht aktiviert.
NDIS_STATUS_RESOURCES	NDIS konnte den NDK-Adapter aufgrund unzureichender Ressourcen nicht öffnen.

Bemerkungen

OPEN_NDK_ADAPTER_HANDLER öffnet eine NDK_ADAPTER Instanz auf einem NDK-fähigen NDIS-Miniportadapter. Mehrere NDK_ADAPTER Instanzen können auf dem gleichen NDIS-Miniportadapter erstellt werden. Jede NDK_ADAPTER Instanz enthält einen Zeiger auf eine Tabelle mit Verteilerfunktionen, die die NDK-Anwendungsprogrammierschnittstelle implementieren. Der Miniporttreiber ruft die CLOSE_NDK_ADAPTER_HANDLER-Funktion auf, um die NDK-Adapterinstanz zu schließen und die zugehörigen Ressourcen freizugeben.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Keine unterstützt,in NDIS 6.30 und höher unterstützt.
mindestens unterstützte Server-	Windows Server 2012
Zielplattform-	Fenster
Header-	ndisndk.h
IRQL-	PASSIVE_LEVEL