Compartir a través de

Función NdisIfQueryBindingIfIndex (ndis.h)

  • Artículo

La función NdisIfQueryBindingIfIndex recupera los índices de interfaz de red y NET_LUID valores para las interfaces de red con capas más altas y bajas asociadas a un enlace de protocolo especificado.

Sintaxis

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

Parámetros

[in] NdisBindingHandle

Identificador que identifica el enlace para el que NDIS debe obtener los valores de NET_LUID y los índices de interfaz de red. NDIS proporcionó este identificador en el parámetro NdisBindingHandle de la función NdisOpenAdapterEx .

[out] pBoundIfIndex

Puntero a una variable de índice de interfaz proporcionada por el autor de la llamada. Si NdisIfQueryBindingIfIndex se realiza correctamente, NDIS escribe en esta variable el índice de la interfaz de red de la interfaz de red asociada al enlace especificado y es más alto en la pila de controladores.

[out] pBoundIfNetLuid

Puntero a una variable de NET_LUID proporcionada por el autor de la llamada. Si NdisIfQueryBindingIfIndex se realiza correctamente, NDIS escribe en esta variable el valor NET_LUID de la interfaz de red asociada al enlace especificado y es más alto en la pila de controladores.

[out] pLowestIfIndex

Puntero a una variable de índice de interfaz proporcionada por el autor de la llamada. Si NdisIfQueryBindingIfIndex se realiza correctamente, NDIS escribe en esta variable el índice de la interfaz de red de la interfaz de red asociada al enlace especificado y es más bajo en la pila de controladores.

[out] pLowestIfNetLuid

Puntero a una variable de NET_LUID proporcionada por el autor de la llamada. Si NdisIfQueryBindingIfIndex se realiza correctamente, NDIS escribe en esta variable el valor NET_LUID de la interfaz de red asociada al enlace especificado y es menor en la pila de controladores.

Valor devuelto

NdisIfQueryBindingIfIndex devuelve uno de los siguientes valores de estado:

Código devuelto Descripción
NDIS_STATUS_SUCCESS
 La operación se ha completado correctamente.
NDIS_STATUS_INTERFACE_NOT_FOUND
 Error de NdisIfQueryBindingIfIndex porque el enlace especificado no está asociado a una interfaz registrada.

Comentarios

Los controladores de protocolo NDIS pueden llamar a la función NdisIfQueryBindingIfIndex para recuperar los índices de la interfaz de red y NET_LUID valores asociados a un enlace.

NdisIfQueryBindingIfIndex proporciona el valor de NET_LUID y el índice de interfaz para la interfaz más alta y la interfaz más baja asociadas al enlace. Estos valores son diferentes, por ejemplo, si el adaptador de minipuerto que está asociado directamente con el enlace especificado es el miniporte virtual de un controlador intermedio de filtro o si hay un módulo de filtro configurado sobre el adaptador de miniporte.

Los controladores de protocolo también pueden obtener el índice de interfaz y NET_LUID de las interfaces más altas y las más bajas de una pila de controladores en la estructura NDIS_BIND_PARAMETERS .

Requisitos

Requisito Value
Cliente mínimo compatible Compatible con NDIS 6.0 y versiones posteriores.
Plataforma de destino Escritorio
Encabezado ndis.h (incluya Ndis.h)
Library Ndis.lib
IRQL PASSIVE_LEVEL
Reglas de cumplimiento de DDI Irql_Interfaces_Function(ndis)

Consulte también

NDIS_BIND_PARAMETERS

NET_LUID

NdisOpenAdapterEx