NDIS_SWITCH_REFERENCE_SWITCH_NIC função de retorno de chamada (ndis.h)

Artigo
02/07/2025

A função ReferenceSwitchNic incrementa o contador de referência de comutador extensível Hyper-V para um adaptador de rede conectado a uma porta de comutador extensível.

Sintaxe

NDIS_SWITCH_REFERENCE_SWITCH_NIC NdisSwitchReferenceSwitchNic;

NDIS_STATUS NdisSwitchReferenceSwitchNic(
  [in] NDIS_SWITCH_CONTEXT NdisSwitchContext,
  [in] NDIS_SWITCH_PORT_ID SwitchPortId,
  [in] NDIS_SWITCH_NIC_INDEX SwitchNicIndex
)
{...}

Parâmetros

[in] NdisSwitchContext

Um valor NDIS_SWITCH_CONTEXT que contém o identificador do módulo de comutador extensível ao qual a extensão do comutador extensível Hyper-V está anexada. Quando a extensão chama NdisFGetOptionalSwitchHandlers, esse identificador é retornado por meio do parâmetro NdisSwitchContext.

[in] SwitchPortId

Um valor NDIS_SWITCH_PORT_ID que contém o identificador exclusivo da porta de comutador extensível à qual o adaptador de rede virtual está conectado.

[in] SwitchNicIndex

Um valor NDIS_SWITCH_NIC_INDEX que especifica o índice do adaptador de rede virtual para o qual o contador de referência de comutador extensível deve ser incrementado.

Para obter mais informações sobre valores NDIS_SWITCH_NIC_INDEX, consulte valores de índice do adaptador de rede.

Observação Esse parâmetro deve especificar o valor de índice de um adaptador de rede que está em um estado conectado. Valores de índice para adaptadores de rede que estão em um estado criado ou desconectado não podem ser especificados. Para obter mais informações sobre estados de conexão de rede, consulte Hyper-V Porta do Comutador Extensível e Estados do Adaptador de Rede.

Valor de retorno

Se a chamada for bem-sucedida, a função retornará NDIS_STATUS_SUCCESS. Caso contrário, ele retornará um código de erro NDIS_STATUS_Xxx definido em Ndis.h.

Observações

A extensão de comutador extensível chama ReferenceSwitchNic para incrementar um contador de referência para um adaptador de rede conectado a uma porta de comutador extensível. Embora o contador de referência tenha um valor diferente de zero, a borda do protocolo do comutador extensível não emitirá uma solicitação de conjunto OID (identificador de objeto) de OID_SWITCH_NIC_DELETE para excluir a conexão com o adaptador.

Depois que a extensão chama ReferenceSwitchNic, ela deve chamar DereferenceSwitchNic para decrementar o contador de referência de comutador extensível.

A extensão deve chamar ReferenceSwitchNic antes de executar as seguintes operações:

Encaminha uma solicitação OID OID_SWITCH_NIC_REQUEST sobre o caminho de controle de comutador extensível para um adaptador de rede físico subjacente.
Para obter mais informações, consulte Gerenciando solicitações de OID para adaptadores de rede física.
Encaminha uma indicação de status NDIS_STATUS_SWITCH_NIC_STATUS sobre o caminho de controle de comutador extensível de um adaptador externo subjacente.
Para obter mais informações, consulte Gerenciando indicações de status do NDIS de adaptadores de rede física.

Observação A extensão não deve chamar ReferenceSwitchNic ao encaminhar pacotes pelo caminho de dados de comutador extensível. A interface de comutador extensível gerencia seus próprios contadores de referência para pacotes que são encaminhados para portas e conexões de adaptador de rede pelo caminho de dados.

A extensão chama ReferenceSwitchNic depois que a conexão do adaptador de rede atingiu a conexão do adaptador de rede criada estado. A extensão não deve chamar ReferenceSwitchNic depois que a conexão tiver atingido o adaptador de rede desconectado ou adaptador de rede excluído estados. Para obter mais informações sobre esses estados, consulte Hyper-V Extensible Switch Port and Network Adapter States.

Observação Quando a extensão chama ReferenceSwitchNic, ela não precisa sincronizar a chamada com seu código que manipula solicitações OID. Como resultado, é possível que a extensão chame ReferenceSwitchNic enquanto a borda do protocolo do comutador extensível emite uma solicitação OID de OID_SWITCH_NIC_DISCONNECT. No entanto, se a chamada para ReferenceSwitchNic for concluída com NDIS_STATUS_SUCCESS, a extensão ainda poderá encaminhar OID_SWITCH_NIC_REQUEST solicitação OID ou NDIS_STATUS_SWITCH_NIC_STATUS indicações de status depois de lidar com a solicitação OID OID_SWITCH_NIC_DISCONNECT.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Com suporte no NDIS 6.30 e posterior.
da Plataforma de Destino	Área de trabalho
cabeçalho	ndis.h (inclua Ndis.h)
IRQL	<= DISPATCH_LEVEL