Compartilhar via


Função NdisIfGetInterfaceIndexFromNetLuid (ndis.h)

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

Sintaxe

NDIS_STATUS NdisIfGetInterfaceIndexFromNetLuid(
  [in]  NET_LUID     NetLuid,
  [out] PNET_IFINDEX pIfIndex
);

Parâmetros

[in] NetLuid

Um valor NET_LUID que identifica um adaptador de rede.

[out] pIfIndex

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

Retornar valor

NdisIfGetInterfaceIndexFromNetLuid 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
Falha em NdisIfGetInterfaceIndexFromNetLuid porque o NET_LUID especificado não estava presente na lista de interfaces registradas.

Comentários

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

Para as interfaces gerenciadas pelo serviço de 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 miniporte 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 mais baixas 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 de interface pode ser alterado sem uma reinicialização do computador. Desregistrar 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 NdisIfGetNetLuidFromInterfaceIndex para obter o valor NET_LUID associado a um índice de interface 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 de DDI Irql_Interfaces_Function(ndis)

Confira também

NDIS_BIND_PARAMETERS

NDIS_FILTER_ATTACH_PARAMETERS

NDIS_MAKE_NET_LUID

NDIS_MINIPORT_INIT_PARAMETERS

NET_LUID

NdisIfGetNetLuidFromInterfaceIndex

NdisIfRegisterInterface