NdisIfFreeNetLuidIndex, fonction (ndis.h)
La fonction NdisIfFreeNetLuidIndex libère une interface réseau NET_LUID index précédemment alloué par un appel à Fonction NdisIfAllocateNetLuidIndex .
Syntaxe
NDIS_STATUS NdisIfFreeNetLuidIndex(
NET_IFTYPE ifType,
[in] UINT32 NetLuidIndex
);
Paramètres
ifType
Type d’interface pour lequel l’index a été alloué. L’appelant doit fournir la même valeur que celle utilisée lorsqu’il a alloué l’index NET_LUID avec NdisIfAllocateNetLuidIndex. Pour obtenir la liste des types d’interface, consultez Types d’interface NDIS.
[in] NetLuidIndex
Valeur d’index NET_LUID que NDIS doit libérer. Cet index a été alloué lors d’un appel précédent à NdisIfAllocateNetLuidIndex.
Valeur retournée
NdisIfFreeNetLuidIndex retourne l’une des valeurs suivantes :
Code de retour | Description |
---|---|
|
L’opération s’est terminée avec succès. |
|
NdisIfFreeNetLuidIndex a échoué, car le paramètre NetLuidIndex a spécifié un index qui n’a pas été alloué pour le type spécifié par le paramètre IfType . |
Si l’appel à NdisIfFreeNetLuidIndex échoue, le fournisseur d’interface doit supprimer toutes les informations enregistrées dans le stockage persistant liés à l’index. La suppression des informations garantit que le fournisseur ne continue pas à essayer de libérer un index déjà libéré après le redémarrage de l’ordinateur.
Remarques
Les fournisseurs d’interface NDIS appellent la fonction NdisIfFreeNetLuidIndex pour libérer un index NET_LUID . Le fournisseur d’interface ne doit libérer l’index NET_LUID que si l’interface ne sera plus utilisée sur l’ordinateur local.
NdisIfFreeNetLuidIndex retourne un index de NET_LUID précédemment alloué à NDIS pour une réallocation possible vers une autre interface. L’appelant doit passer le même type d’interface au niveau IfType qu’il a utilisé lorsqu’il a appelé le Fonction NdisIfAllocateNetLuidIndex pour allouer l’index NET_LUID.
Le fournisseur ne doit pas utiliser l’index de NET_LUID libéré ou la valeur de NET_LUID associée dans d’autres appels de fonction NDIS après avoir appelé NdisIfFreeNetLuidIndex.
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) |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour