NdisIfGetInterfaceIndexFromNetLuid, fonction (ndis.h)

Article
02/26/2024

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 retournée

NdisIfGetInterfaceIndexFromNetLuid 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	Échec de NdisIfGetInterfaceIndexFromNetLuid , car le NET_LUID spécifié n’était pas présent 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 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 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 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 NdisIfGetNetLuidFromInterfaceIndex pour obtenir la valeur NET_LUID associée à un index d’interface 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)