Función NdisIfGetNetLuidFromInterfaceIndex (ndis.h)

Artículo
08/07/2023

La función NdisIfGetNetLuidFromInterfaceIndex obtiene el valor de NET_LUID asociado a un índice de interfaz de red.

Sintaxis

NDIS_STATUS NdisIfGetNetLuidFromInterfaceIndex(
        NET_IFINDEX ifIndex,
  [out] PNET_LUID   pNetLuid
);

Parámetros

ifIndex

Índice de interfaz de red que NDIS asignó a un valor de NET_LUID en el Función NdisIfRegisterInterface .

[out] pNetLuid

Puntero a una variable de NET_LUID proporcionada por el autor de la llamada. Si NdisIfGetNetLuidFromInterfaceIndex se realiza correctamente, NDIS escribe el valor de NET_LUID asociado al índice de interfaz de red especificado en esta variable.

Valor devuelto

NdisIfGetNetLuidFromInterfaceIndex 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 NdisIfGetNetLuidFromInterfaceIndex porque el índice de interfaz de red especificado no está asignado a una interfaz registrada.

Comentarios

Los controladores NDIS pueden llamar a la función NdisIfGetNetLuidFromInterfaceIndex para obtener el valor de NET_LUID asociado a un índice de interfaz de red.

Para las interfaces que administra el servicio del proveedor de proxy NDIS, NDIS proporciona el índice de interfaz y NET_LUID en varias estructuras de inicialización de controladores:

Los controladores miniport pueden obtener el índice de interfaz y NET_LUID para un adaptador de minipuerto en el NDIS_MINIPORT_INIT_PARAMETERS estructura.
Los controladores de filtro pueden obtener el índice de interfaz y NET_LUID para un módulo de filtro en . NDIS_FILTER_ATTACH_PARAMETERS estructura.
Los controladores de protocolo pueden obtener el índice de interfaz y NET_LUID de las interfaces más altas y inferiores en una pila de controladores de la estructura NDIS_BIND_PARAMETERS .

NDIS asigna un índice de interfaz a una interfaz de red cuando el proveedor de interfaz llama a la función NdisIfRegisterInterface . Un proveedor de interfaz llama a la macro NDIS_MAKE_NET_LUID para crear el valor de NET_LUID antes de registrar una interfaz.

El valor del índice de interfaz puede cambiar sin un reinicio del equipo. Anular el registro y volver a registrar una interfaz asociada a un valor de NET_LUID podría dar lugar a valores de índice de interfaz diferentes. No confunda el índice de interfaz con el índice de NET_LUID que persiste después de reiniciar un equipo.

NDIS proporciona el Función NdisIfGetInterfaceIndexFromNetLuid para obtener el índice de interfaz de un NET_LUID especificado.

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)