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

A função DereferenceSwitchNic diminui o contador de referência de comutador extensível do Hyper-V para um adaptador de rede conectado a uma porta de comutador extensível. O contador de referência foi incrementado por meio de uma chamada anterior para ReferenceSwitchNic.

Sintaxe

NDIS_SWITCH_DEREFERENCE_SWITCH_NIC NdisSwitchDereferenceSwitchNic;

NDIS_STATUS NdisSwitchDereferenceSwitchNic(
  [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 do 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 de NDIS_SWITCH_NIC_INDEX, consulte Valores de índice do adaptador de rede.

Retornar valor

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.

Comentários

A extensão de comutador extensível chama DereferenceSwitchNic para diminuir o contador de referência para um adaptador de rede conectado a uma porta de comutador extensível. Embora o contador de referência de comutador extensível 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.

A extensão deve chamar DereferenceSwitchNic se já tivesse chamado ReferenceSwitchNic para uma conexão de adaptador de rede.

Requisitos

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

Confira também

NdisFGetOptionalSwitchHandlers

OID_SWITCH_NIC_DELETE

ReferenceSwitchNic