Função NdisIfGetNetLuidFromInterfaceIndex (ndis.h)

Artigo
02/29/2024

A função NdisIfGetNetLuidFromInterfaceIndex obtém o valor NET_LUID associado a um índice de interface de rede.

Sintaxe

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

Parâmetros

ifIndex

Um índice de interface de rede que o NDIS atribuiu a um valor NET_LUID no Função NdisIfRegisterInterface .

[out] pNetLuid

Um ponteiro para uma variável de NET_LUID fornecida pelo chamador. Se NdisIfGetNetLuidFromInterfaceIndex for bem-sucedido, o NDIS gravará o valor NET_LUID associado ao índice de interface de rede especificado nessa variável.

Retornar valor

NdisIfGetNetLuidFromInterfaceIndex retorna um dos seguintes valores de status:

Código de retorno	Descrição
NDIS_STATUS_SUCCESS	A operação foi concluída com sucesso.
NDIS_STATUS_INTERFACE_NOT_FOUND	NdisIfGetNetLuidFromInterfaceIndex falhou porque o índice de adaptador de rede especificado não está atribuído a uma interface registrada.

Comentários

Os drivers NDIS podem chamar a função NdisIfGetNetLuidFromInterfaceIndex para obter o valor NET_LUID associado a um índice de interface de rede.

Para as interfaces gerenciadas pelo serviço do provedor de proxy NDIS, o NDIS fornece o índice de interface e NET_LUID em várias estruturas de inicialização de driver:

Os drivers de miniport podem obter o índice de interface e NET_LUID para um adaptador de miniporta no NDIS_MINIPORT_INIT_PARAMETERS estrutura.
Os drivers de filtro podem obter o índice de interface e NET_LUID para um módulo de filtro no NDIS_FILTER_ATTACH_PARAMETERS estrutura.
Os drivers de protocolo podem obter o índice de interface e NET_LUID das interfaces mais altas e inferiores em uma pilha de driver na estrutura NDIS_BIND_PARAMETERS .

O NDIS atribui um índice de interface a um adaptador de rede quando o provedor de interface chama a função NdisIfRegisterInterface . Um provedor de interface chama a macro NDIS_MAKE_NET_LUID para criar o valor NET_LUID antes de registrar uma interface.

O valor do índice da interface pode ser alterado sem uma reinicialização do computador. Cancelar o registro e registrar novamente uma interface associada a um valor NET_LUID pode resultar em valores de índice de interface diferentes. Não confunda o índice de interface com o índice NET_LUID que persiste após a reinicialização de um computador.

O NDIS fornece o Função NdisIfGetInterfaceIndexFromNetLuid para obter o índice de interface de um NET_LUID especificado.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Com suporte no NDIS 6.0 e posterior.
Plataforma de Destino	Área de Trabalho
Cabeçalho	ndis.h (inclua Ndis.h)
Biblioteca	Ndis.lib
IRQL	PASSIVE_LEVEL
Regras de conformidade da DDI	Irql_Interfaces_Function(ndis)