NdisIfGetNetLuidFromInterfaceIndex, fonction (ndis.h)
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 |
---|---|
|
L’opération s’est terminée avec succès. |
|
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 .
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) |