NdisIfQueryBindingIfIndex, fonction (ndis.h)

  • Article

La fonction NdisIfQueryBindingIfIndex récupère les index d’interface réseau et les valeurs NET_LUID pour les interfaces réseau les plus hautes et les plus basses qui sont associées à une liaison de protocole spécifiée.

Syntaxe

NDIS_STATUS NdisIfQueryBindingIfIndex(
  [in]  NDIS_HANDLE  NdisBindingHandle,
  [out] PNET_IFINDEX pBoundIfIndex,
  [out] PNET_LUID    pBoundIfNetLuid,
  [out] PNET_IFINDEX pLowestIfIndex,
  [out] PNET_LUID    pLowestIfNetLuid
);

Paramètres

[in] NdisBindingHandle

Handle qui identifie la liaison pour laquelle NDIS doit obtenir les valeurs NET_LUID et les index d’interface réseau. NDIS a fourni ce handle au paramètre NdisBindingHandle de la fonction NdisOpenAdapterEx .

[out] pBoundIfIndex

Pointeur vers une variable d’index d’interface fournie par l’appelant. Si NdisIfQueryBindingIfIndex réussit, NDIS écrit dans cette variable l’index d’interface réseau de l’interface réseau qui est associé à la liaison spécifiée et qui est le plus élevé dans la pile de pilotes.

[out] pBoundIfNetLuid

Pointeur vers une variable NET_LUID fournie par l’appelant. Si NdisIfQueryBindingIfIndex réussit, NDIS écrit dans cette variable la valeur NET_LUID de l’interface réseau associée à la liaison spécifiée et qui est la plus élevée dans la pile de pilotes.

[out] pLowestIfIndex

Pointeur vers une variable d’index d’interface fournie par l’appelant. Si NdisIfQueryBindingIfIndex réussit, NDIS écrit dans cette variable l’index d’interface réseau de l’interface réseau qui est associé à la liaison spécifiée et qui est le plus bas dans la pile de pilotes.

[out] pLowestIfNetLuid

Pointeur vers une variable NET_LUID fournie par l’appelant. Si NdisIfQueryBindingIfIndex réussit, NDIS écrit dans cette variable la valeur NET_LUID de l’interface réseau associée à la liaison spécifiée et qui est la plus basse dans la pile de pilotes.

Valeur retournée

NdisIfQueryBindingIfIndex retourne l’une des valeurs status suivantes :

Code de retour Description
NDIS_STATUS_SUCCESS
 L’opération s’est terminée avec succès.
NDIS_STATUS_INTERFACE_NOT_FOUND
 NdisIfQueryBindingIfIndex a échoué, car la liaison spécifiée n’est pas associée à une interface inscrite.

Remarques

Les pilotes de protocole NDIS peuvent appeler la fonction NdisIfQueryBindingIfIndex pour récupérer les index d’interface réseau et NET_LUID valeurs associées à une liaison.

NdisIfQueryBindingIfIndex fournit la valeur NET_LUID et l’index d’interface pour l’interface la plus élevée et l’interface la plus basse associée à la liaison. Ces valeurs sont différentes, par exemple, si l’adaptateur miniport directement associé à la liaison spécifiée est le miniport virtuel d’un pilote intermédiaire de filtre ou s’il existe un module de filtre configuré sur l’adaptateur miniport.

Les pilotes de protocole peuvent également obtenir l’index d’interface et les NET_LUID des interfaces les plus élevées et les plus basses d’une pile de pilotes dans la structure NDIS_BIND_PARAMETERS .

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

NDIS_BIND_PARAMETERS

NET_LUID

NdisOpenAdapterEx