OPEN_NDK_ADAPTER_HANDLER Rückruffunktion (ndisndk.h)

Artikel
02/29/2024

Die Funktion OpenNDKAdapterHandler (OPEN_NDK_ADAPTER_HANDLER) öffnet einen NDK-Adapter instance 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 für einen Kontextbereich, den der Miniporttreiber in seiner MiniportInitializeEx-Funktion zugeordnet hat. Der Miniporttreiber verwendet diesen Kontextbereich, um Zustandsinformationen für einen NDIS-Miniportadapter zu verwalten.

[in] Parameters

Ein Zeiger auf eine NDIS_OPEN_NDK_ADAPTER_PARAMETERS-Struktur, die die Eingabeparameter definiert, um eine NDK_ADAPTER instance 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 Consumer angegebene Hauptversion nicht unterstützt, muss der Anbieter die Anforderung mit NDIS_STATUS_BAD_VERSION fehlschlagen.

Wenn der Anbieter die vom Consumer 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 beispielsweise Version 1.0 anfordert und der Anbieter 1.1 unterstützt, muss der Anbieter Version 1.1 in der NDK_ADAPTER_INFO-Struktur und den NDK-Objektheadern melden.

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

Wenn der Anbieter die vom Consumer angegebene Hauptversion unterstützt und die angegebene Nebenversion größer als die höchste Vom Anbieter unterstützte Nebenversion ist, muss der Anbieter die Anforderung mit NDIS_STATUS_BAD_VERSION fehlschlagen.

ppNdkAdapter

Ein Zeiger auf eine Variable, die den Zeiger auf eine NDK_ADAPTER-Struktur enthält. Bei der Rückkehr von OPEN_NDK_ADAPTER_HANDLER identifiziert die NDK_ADAPTER-Struktur, auf die von ppNdkAdapter verwiesen wird, den neu geöffneten NDK-Adapter instance.

Rückgabewert

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

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

Hinweise

OPEN_NDK_ADAPTER_HANDLER öffnet eine NDK_ADAPTER instance auf einem NDK-fähigen NDIS-Miniportadapter. Mehrere NDK_ADAPTER-Instanzen können auf demselben NDIS-Miniportadapter erstellt werden. Jede NDK_ADAPTER instance enthält einen Zeiger auf eine Tabelle mit Dispatchfunktionen, die die NDK-Anwendungsprogrammierschnittstelle implementieren. Der Miniporttreiber ruft die CLOSE_NDK_ADAPTER_HANDLER-Funktion auf, um den NDK-Adapter instance zu schließen und die zugeordneten Ressourcen freizugeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Keine unterstützt, unterstützt in NDIS 6.30 und höher.
Unterstützte Mindestversion (Server)	Windows Server 2012
Zielplattform	Windows
Kopfzeile	ndisndk.h
IRQL	PASSIVE_LEVEL