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

A função DereferenceSwitchPort diminui o contador de referência de comutador extensível do Hyper-V para uma porta de comutador extensível. O contador de referência foi incrementado por meio de uma chamada anterior para ReferenceSwitchPort.

Sintaxe

NDIS_SWITCH_DEREFERENCE_SWITCH_PORT NdisSwitchDereferenceSwitchPort;

NDIS_STATUS NdisSwitchDereferenceSwitchPort(
  [in] NDIS_SWITCH_CONTEXT NdisSwitchContext,
  [in] NDIS_SWITCH_PORT_ID SwitchPortId
)
{...}

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 para a qual o contador de referência de comutador extensível é incrementado.

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 DereferenceSwitchPort para decrementar o contador de referência para 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_PORT_DELETE para excluir a porta.

A extensão deve chamar DereferenceSwitchPort se já tivesse chamado ReferenceSwitchPort para uma porta de comutador extensível.

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_PORT_DELETE

ReferenceSwitchPort