NdisIfFreeNetLuidIndex, fonction (ndis.h)

Article
02/26/2024

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
NDIS_STATUS_SUCCESS	L’opération s’est terminée avec succès.
DIS_STATUS_INVALID_PARAMETER	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

NET_LUID

NdisIfAllocateNetLuidIndex

Partager via