NdisIfGetNetLuidFromInterfaceIndex, fonction (ndis.h)

Article
08/07/2023

La fonction NdisIfGetNetLuidFromInterfaceIndex obtient la valeur NET_LUID associée à un index d’interface réseau.

Syntaxe

NDIS_STATUS NdisIfGetNetLuidFromInterfaceIndex(
        NET_IFINDEX ifIndex,
  [out] PNET_LUID   pNetLuid
);

Paramètres

ifIndex

Index d’interface réseau affecté par NDIS à une valeur NET_LUID dans le Fonction NdisIfRegisterInterface .

[out] pNetLuid

Pointeur vers une variable NET_LUID fournie par l’appelant. Si NdisIfGetNetLuidFromInterfaceIndex réussit, NDIS écrit la valeur NET_LUID associée à l’index d’interface réseau spécifié dans cette variable.

Valeur retournée

NdisIfGetNetLuidFromInterfaceIndex retourne l’une des valeurs status suivantes :

Code de retour	Description
NDIS_STATUS_SUCCESS	L’opération s’est terminée avec succès.
NDIS_STATUS_INTERFACE_NOT_FOUND	NdisIfGetNetLuidFromInterfaceIndex a échoué, car l’index d’interface réseau spécifié n’est pas affecté à une interface inscrite.

Remarques

Les pilotes NDIS peuvent appeler la fonction NdisIfGetNetLuidFromInterfaceIndex pour obtenir la valeur NET_LUID associée à un index d’interface réseau.

Pour les interfaces que le service du fournisseur de proxy NDIS gère, NDIS fournit l’index d’interface et NET_LUID dans différentes structures d’initialisation de pilote :

Les pilotes Miniport peuvent obtenir l’index d’interface et les NET_LUID d’un adaptateur miniport dans le NDIS_MINIPORT_INIT_PARAMETERS structure.
Les pilotes de filtre peuvent obtenir l’index d’interface et NET_LUID pour un module de filtre dans le NDIS_FILTER_ATTACH_PARAMETERS structure.
Les pilotes de protocole peuvent obtenir l’index d’interface et les NET_LUID des interfaces les plus élevées et les interfaces inférieures sur une pile de pilotes dans la structure NDIS_BIND_PARAMETERS .

NDIS affecte un index d’interface à une interface réseau lorsque le fournisseur d’interface appelle la fonction NdisIfRegisterInterface . Un fournisseur d’interface appelle la macro NDIS_MAKE_NET_LUID pour créer la valeur NET_LUID avant d’inscrire une interface.

La valeur d’index de l’interface peut changer sans redémarrage de l’ordinateur. La désinscription et la réinscription d’une interface associée à une valeur NET_LUID peuvent entraîner des valeurs d’index d’interface différentes. Ne confondez pas l’index d’interface avec l’index NET_LUID qui persiste après le redémarrage d’un ordinateur.

NDIS fournit le Fonction NdisIfGetInterfaceIndexFromNetLuid pour obtenir l’index d’interface d’un NET_LUID spécifié.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Pris en charge dans NDIS 6.0 et versions ultérieures.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	ndis.h (inclure Ndis.h)
Bibliothèque	Ndis.lib
IRQL	PASSIVE_LEVEL
Règles de conformité DDI	Irql_Interfaces_Function(ndis)