Compartir a través de


Función NdisIfGetNetLuidFromInterfaceIndex (ndis.h)

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)

Consulte también

NDIS_BIND_PARAMETERS

NDIS_FILTER_ATTACH_PARAMETERS

NDIS_MAKE_NET_LUID

NDIS_MINIPORT_INIT_PARAMETERS

NET_LUID

NdisIfGetInterfaceIndexFromNetLuid

NdisIfRegisterInterface