OPEN_NDK_ADAPTER_HANDLER fonction de rappel (ndisndk.h)

Article
08/07/2023

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

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 à une zone de contexte que le pilote miniport a allouée 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 de NDIS_OPEN_NDK_ADAPTER_PARAMETERS qui définit les paramètres d’entrée pour ouvrir un instance NDK_ADAPTER.

La structure NDIS_OPEN_NDK_ADAPTER_PARAMETERS doit spécifier la version principale de 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 majeure 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 les en-têtes de structure NDK_ADAPTER_INFO et d’objet NDK.

Note Les versions mineures supérieures du fournisseur sont toujours entièrement rétrocompatibles avec (c’est-à-dire 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 . Au retour de OPEN_NDK_ADAPTER_HANDLER, la structure NDK_ADAPTER référencée par ppNdkAdapter identifie l’adaptateur NDK nouvellement ouvert instance.

Valeur retournée

OPEN_NDK_ADAPTER_HANDLER pouvez retourner l’une des valeurs suivantes :

Code de retour	Description
NDIS_STATUS_SUCCESS	L’adaptateur NDK instance a été ouvert.
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 un instance NDK_ADAPTER sur un adaptateur miniport NDIS compatible NDK. Plusieurs instances NDK_ADAPTER peuvent être créées sur le même adaptateur miniport NDIS. Chaque NDK_ADAPTER instance 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’adaptateur NDK instance et libérer les ressources associées.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge, pris en charge dans NDIS 6.30 et versions ultérieures.
Serveur minimal pris en charge	Windows Server 2012
Plateforme cible	Windows
En-tête	ndisndk.h
IRQL	PASSIVE_LEVEL