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