OPEN_NDK_ADAPTER_HANDLER fonction de rappel (ndisndk.h)

Article
02/07/2025

La fonction OpenNDKAdapterHandler (OPEN_NDK_ADAPTER_HANDLER) ouvre une instance d’adaptateur NDK sur un adaptateur NDK compatible NDIS.

Syntaxe

OPEN_NDK_ADAPTER_HANDLER OpenNdkAdapterHandler;

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

Paramètres

[in] MiniportAdapterContext

Handle vers une zone de contexte allouée par le pilote miniport dans sa fonction MiniportInitializeEx. Le pilote miniport utilise cette zone de contexte pour conserver les informations d’état d’un adaptateur miniport NDIS.

[in] Parameters

Pointeur vers une structure NDIS_OPEN_NDK_ADAPTER_PARAMETERS qui définit les paramètres d’entrée pour ouvrir une instance NDK_ADAPTER.

La structure NDIS_OPEN_NDK_ADAPTER_PARAMETERS doit spécifier la version principale du NDKPI et la version mineure NDKPI la plus basse que le consommateur NDK peut prendre en charge.

Si le fournisseur ne prend pas en charge la version principale spécifiée par le consommateur, le fournisseur doit échouer à la demande avec NDIS_STATUS_BAD_VERSION.

Si le fournisseur prend en charge la version principale spécifiée par le consommateur et que la version mineure spécifiée est inférieure ou égale à la version mineure la plus élevée prise en charge par le fournisseur, le fournisseur doit réussir la demande et utiliser la version mineure la plus élevée prise en charge par le fournisseur.

Par exemple, si le consommateur demande la version 1.0 et que le fournisseur prend en charge la version 1.1, le fournisseur doit signaler la version 1.1 dans la structure NDK_ADAPTER_INFO et les en-têtes d’objets NDK.

Remarque versions mineures supérieures du fournisseur sont toujours entièrement compatibles avec (autrement dit, un sur-ensemble de versions mineures inférieures).

Si le fournisseur prend en charge la version principale spécifiée par le consommateur et que la version mineure spécifiée est supérieure à la version mineure la plus élevée prise en charge par le fournisseur, le fournisseur doit échouer à la demande avec NDIS_STATUS_BAD_VERSION.

ppNdkAdapter

Pointeur vers une variable qui contient le pointeur vers une structure NDK_ADAPTER. Lors du retour de OPEN_NDK_ADAPTER_HANDLER, la structure NDK_ADAPTER référencée par ppNdkAdapter identifie l’instance d’adaptateur NDK nouvellement ouverte.

Valeur de retour

OPEN_NDK_ADAPTER_HANDLER pouvez retourner l’une des valeurs suivantes :

Retourner le code	Description
NDIS_STATUS_SUCCESS	L’instance de l’adaptateur NDK a été ouverte.
NDIS_STATUS_BAD_VERSION	Le numéro de version demandé n’est pas pris en charge.
NDIS_STATUS_ADAPTER_NOT_READY	La fonctionnalité NDK de l’adaptateur miniport n’est pas activée.
NDIS_STATUS_RESOURCES	NDIS n’a pas pu ouvrir l’adaptateur NDK en raison de ressources insuffisantes.

Remarques

OPEN_NDK_ADAPTER_HANDLER ouvre une instance de NDK_ADAPTER sur un adaptateur miniport NDK compatible NDK. Plusieurs instances de NDK_ADAPTER peuvent être créées sur le même adaptateur miniport NDIS. Chaque instance NDK_ADAPTER contient un pointeur vers une table de fonctions de répartition qui implémentent l’interface de programmation d’application NDK. Le pilote miniport appelle la fonction CLOSE_NDK_ADAPTER_HANDLER pour fermer l’instance de l’adaptateur NDK et libérer les ressources associées.

Exigences

Exigence	Valeur
client minimum pris en charge	Aucune prise en charge, prise en charge dans NDIS 6.30 et versions ultérieures.
serveur minimum pris en charge	Windows Server 2012
plateforme cible	Windows
d’en-tête	ndisndk.h
IRQL	PASSIVE_LEVEL