Función NdisIfGetNetLuidFromInterfaceIndex (ndis.h)

2025-02-07

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

Observaciones

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 de proveedor de proxy NDIS, NDIS proporciona el índice de interfaz y NET_LUID en varias estructuras de inicialización de controladores:

Los controladores de miniport pueden obtener el índice de interfaz y NET_LUID para un adaptador de miniporte en el estructura NDIS_MINIPORT_INIT_PARAMETERS.
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 reiniciar el equipo. Anular el registro y volver a registrar una interfaz asociada a un valor de NET_LUID podría dar lugar a diferentes valores de índice de interfaz. 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	Valor
cliente mínimo admitido	Se admite en NDIS 6.0 y versiones posteriores.
de la plataforma de destino de	Escritorio
encabezado de	ndis.h (incluya Ndis.h)
biblioteca de	Ndis.lib
irQL	PASSIVE_LEVEL
reglas de cumplimiento de DDI	Irql_Interfaces_Function(ndis)