NdisIfGetInterfaceIndexFromNetLuid, fonction (ndis.h)

Article
02/07/2025

La fonction NdisIfGetInterfaceIndexFromNetLuid obtient l’index d’interface réseau associé à une valeur NET_LUID.

Syntaxe

NDIS_STATUS NdisIfGetInterfaceIndexFromNetLuid(
  [in]  NET_LUID     NetLuid,
  [out] PNET_IFINDEX pIfIndex
);

Paramètres

[in] NetLuid

Valeur NET_LUID qui identifie une interface réseau.

[out] pIfIndex

Pointeur vers une variable d’index d’interface fournie par l’appelant. Si NdisIfGetInterfaceIndexFromNetLuid réussit, NDIS écrit l’index d’interface réseau associé au NET_LUID spécifié dans cette variable.

Valeur de retour

NdisIfGetInterfaceIndexFromNetLuid retourne l’une des valeurs d’état suivantes :

Retourner le code	Description
NDIS_STATUS_SUCCESS	L’opération s’est terminée avec succès.
NDIS_STATUS_INTERFACE_NOT_FOUND	NdisIfGetInterfaceIndexFromNetLuid a échoué, car la NET_LUID spécifiée n’était pas présente dans la liste des interfaces inscrites.

Remarques

Les pilotes NDIS peuvent appeler la fonction NdisIfGetInterfaceIndexFromNetLuid pour obtenir l’index d’interface réseau associé à une valeur NET_LUID.

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 NET_LUID pour un adaptateur miniport dans le structure NDIS_MINIPORT_INIT_PARAMETERS.
Les pilotes de filtre peuvent obtenir l’index d’interface et NET_LUID pour un module de filtre dans le structure NDIS_FILTER_ATTACH_PARAMETERS.
Les pilotes de protocole peuvent obtenir l’index d’interface et NET_LUID des interfaces les plus élevées et les plus basses 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 de l’index d’interface peut changer sans redémarrage de l’ordinateur. L’inscription 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 NdisIfGetNetLuidFromInterfaceIndex pour obtenir la valeur NET_LUID associée à un index d’interface spécifié.

Exigences

Exigence	Valeur
client minimum pris en charge	Prise en charge dans NDIS 6.0 et versions ultérieures.
plateforme cible	Bureau
d’en-tête	ndis.h (include Ndis.h)
bibliothèque	Ndis.lib
IRQL	PASSIVE_LEVEL
règles de conformité DDI	Irql_Interfaces_Function(ndis)