NdisIfFreeNetLuidIndex, fonction (ndis.h)

  • Article

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