Função NdisIfAddIfStackEntry (ndis.h)

Artigo
02/07/2025

A função NdisIfAddIfStackEntry especifica a ordenação de duas interfaces de rede na pilha de interface de rede do NDIS.

Sintaxe

NDIS_STATUS NdisIfAddIfStackEntry(
  [in] NET_IFINDEX HigherLayerIfIndex,
  [in] NET_IFINDEX LowerLayerIfIndex
);

Parâmetros

[in] HigherLayerIfIndex

O índice de interface de rede para a interface que deve ser maior na tabela de pilha de interface.

[in] LowerLayerIfIndex

O índice da interface de rede para a interface que deve ser inferior na tabela de pilha de interface.

Valor de retorno

NdisIfAddIfStackEntry retorna um dos seguintes valores de status:

Código de retorno	Descrição
NDIS_STATUS_SUCCESS	A operação foi concluída com êxito.
NDIS_STATUS_RESOURCES	A operação falhou devido a recursos insuficientes.
NDIS_STATUS_INTERFACE_NOT_FOUND	NdisIfAddIfStackEntry falhou porque o índice em HigherLayerIfIndex ou LowerLayerIfIndex não é o índice de uma interface registrada.

Observações

Os drivers NDIS podem chamar a função NdisIfAddIfStackEntry para especificar a ordenação de duas interfaces de rede na pilha de interface do NDIS. O provedor de proxy NDIS especifica a ordem para módulos de filtro e adaptadores de miniporto. O NDIS também especifica a relação entre o miniporto virtual e o adaptador de miniporto subjacente para drivers intermediários de filtro. No entanto, o NDIS não especifica a ordem de pilha para drivers intermediários MUX.

O NDIS mantém uma tabela de pilha de interface ( ifStackTable de RFC 2863). O NDIS fornece o NdisIfAddIfStackEntry e Funções NdisIfDeleteIfStackEntry para adicionar e excluir entradas nesta tabela.

Qualquer driver que possa fornecer as informações sobre a relação de ordem de pilha entre duas interfaces deve chamar NdisIfAddIfStackEntry para preencher a tabela de pilha de interface. O NDIS exclui as entradas de pilha correspondentes para uma interface quando a interface é desregistrado.

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)

Consulte também

NdisIfDeleteIfStackEntry

Compartilhar via