Função NdisIfGetNetLuidFromInterfaceIndex (ndis.h)
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 para essa variável.
Valor de retorno
NdisIfGetNetLuidFromInterfaceIndex retorna um dos seguintes valores de status:
Código de retorno | Descrição |
---|---|
|
A operação foi concluída com êxito. |
|
falha no NdisIfGetNetLuidFromInterfaceIndex porque o índice de interface de rede especificado não está atribuído a uma interface registrada. |
Observações
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 de provedor proxy do 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 miniporto 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 valor do índice de interface pode ser alterado sem uma reinicialização do computador. A desregissão e o novo registro de uma interface associada a um valor NET_LUID podem resultar em diferentes valores de índice de interface. 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 |
---|---|
de cliente com suporte mínimo | Com suporte no NDIS 6.0 e posterior. |
da 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) |