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 |
|---|---|
|
A operação foi concluída com sucesso. |
|
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) |