Función NdisIfQueryBindingIfIndex (ndis.h)
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 |
|---|---|
|
La operación se ha completado correctamente. |
|
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) |