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