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 attribué 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 de retour
NdisIfGetNetLuidFromInterfaceIndex retourne l’une des valeurs d’état suivantes :
| Retourner le code | 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 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 inférieures sur une pile de pilotes dans la structure NDIS_BIND_PARAMETERS.
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 NdisIfGetInterfaceIndexFromNetLuid pour obtenir l’index d’interface d’un NET_LUID spécifié.