Compartilhar via


Função NdisIfQueryBindingIfIndex (ndis.h)

A função NdisIfQueryBindingIfIndex recupera os índices de interface de rede e os valores NET_LUID para as interfaces de rede em camadas mais altas e mais baixas associadas a uma associação de protocolo especificada.

Sintaxe

NDIS_STATUS NdisIfQueryBindingIfIndex(
  [in]  NDIS_HANDLE  NdisBindingHandle,
  [out] PNET_IFINDEX pBoundIfIndex,
  [out] PNET_LUID    pBoundIfNetLuid,
  [out] PNET_IFINDEX pLowestIfIndex,
  [out] PNET_LUID    pLowestIfNetLuid
);

Parâmetros

[in] NdisBindingHandle

Um identificador que identifica a associação para a qual o NDIS deve obter os valores NET_LUID e índices de interface de rede. O NDIS forneceu esse identificador no parâmetro NdisBindingHandle da função NdisOpenAdapterEx .

[out] pBoundIfIndex

Um ponteiro para uma variável de índice de interface fornecida pelo chamador. Se NdisIfQueryBindingIfIndex for bem-sucedido, o NDIS gravará nessa variável o índice de interface de rede do adaptador de rede associado à associação especificada e é mais alto na pilha de driver.

[out] pBoundIfNetLuid

Um ponteiro para uma variável de NET_LUID fornecida pelo chamador. Se NdisIfQueryBindingIfIndex for bem-sucedido, o NDIS gravará nessa variável o valor NET_LUID da interface de rede associada à associação especificada e é mais alta na pilha de driver.

[out] pLowestIfIndex

Um ponteiro para uma variável de índice de interface fornecida pelo chamador. Se NdisIfQueryBindingIfIndex for bem-sucedido, o NDIS gravará nessa variável o índice de interface de rede do adaptador de rede associado à associação especificada e será o mais baixo na pilha de driver.

[out] pLowestIfNetLuid

Um ponteiro para uma variável de NET_LUID fornecida pelo chamador. Se NdisIfQueryBindingIfIndex for bem-sucedido, o NDIS gravará nessa variável o valor NET_LUID da interface de rede associada à associação especificada e será a mais baixa na pilha de driver.

Retornar valor

NdisIfQueryBindingIfIndex 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 NdisIfQueryBindingIfIndex porque a associação especificada não está associada a uma interface registrada.

Comentários

Os drivers de protocolo NDIS podem chamar a função NdisIfQueryBindingIfIndex para recuperar os índices de interface de rede e NET_LUID valores associados a uma associação.

NdisIfQueryBindingIfIndex fornece o valor NET_LUID e o índice de interface para a interface mais alta e a interface mais baixa associadas à associação. Esses valores serão diferentes, por exemplo, se o adaptador de miniporto que está diretamente associado à associação especificada for o miniporto virtual de um driver intermediário de filtro ou se houver um módulo de filtro configurado no adaptador de miniport.

Os drivers de protocolo também 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 .

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

NET_LUID

NdisOpenAdapterEx