NdisIfQueryBindingIfIndex, fonction (ndis.h)
La fonction NdisIfQueryBindingIfIndex récupère les index d’interface réseau et NET_LUID valeurs pour les interfaces réseau les plus élevées et les plus basses 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 de l’interface réseau de l’interface réseau associée à la liaison spécifiée et est le plus élevé dans la pile des 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 est la plus élevée dans la pile des 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 associée à la liaison spécifiée et est le plus bas dans la pile des 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 est la plus basse dans la pile des pilotes.
Valeur de retour
NdisIfQueryBindingIfIndex retourne l’une des valeurs d’état suivantes :
| Retourner le code | Description |
|---|---|
|
L’opération s’est terminée avec succès. |
|
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 faible 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 NET_LUID des interfaces les plus élevées et les plus basses d’une pile de pilotes dans la structure NDIS_BIND_PARAMETERS.