OID_SWITCH_PORT_DELETE

Artigo
06/15/2023

A borda do protocolo do comutador extensível do Hyper-V emite uma solicitação de conjunto de OID (identificador de objeto) de OID_SWITCH_PORT_DELETE para notificar extensíveis extensíveis extensíveis sobre a exclusão de uma porta de comutador extensível.

O membro InformationBuffer da estrutura NDIS_OID_REQUEST contém um ponteiro para uma estrutura NDIS_SWITCH_PORT_PARAMETERS .

Comentários

O membro PortId da estrutura NDIS_SWITCH_PORT_PARAMETERS especifica a porta de comutador extensível para a qual a notificação de exclusão está sendo feita.

Se um adaptador de rede estiver conectado à porta especificada, a borda do protocolo do comutador extensível excluirá a conexão antes de excluir a porta. Nesse caso, a borda do protocolo seguirá estas etapas antes de excluir a porta:

A borda do protocolo emite uma solicitação de conjunto OID de OID_SWITCH_NIC_DISCONNECT para notificar a extensão de que a conexão entre um adaptador de rede e a porta de comutador extensível está sendo excluída.
Depois que todos os pacotes pendentes para a porta de comutador extensível especificada tiverem sido cancelados ou concluídos, a borda do protocolo emite uma solicitação de conjunto OID de OID_SWITCH_NIC_DELETE para notificar a extensão de que a conexão entre um adaptador de rede e a porta de comutador extensível foi excluída.

Neste ponto, a borda do protocolo pode começar a excluir a porta.

A borda do protocolo da opção extensível segue estas etapas quando exclui uma porta de comutador extensível:

A borda do protocolo do comutador extensível emite uma solicitação de conjunto OID de OID_SWITCH_PORT_TEARDOWN. Essa solicitação OID notifica as extensões de comutador extensíveis subjacentes sobre o início do processo de exclusão para uma porta de comutador extensível.
A borda do protocolo emite uma solicitação de conjunto OID de OID_SWITCH_PORT_DELETE depois que todas as solicitações OID para a porta de comutador extensível forem concluídas.

Nota Se a extensão tiver chamado ReferenceSwitchPort anteriormente para incrementar o contador de referência da porta, ela deverá chamar DereferenceSwitchPort antes que a borda do protocolo emita a solicitação de OID_SWITCH_NIC_DELETE .

A extensão deve seguir estas diretrizes para lidar com solicitações de conjunto de OID de OID_SWITCH_PORT_DELETE:

A extensão não deve modificar a estrutura NDIS_SWITCH_PORT_PARAMETERS associada à solicitação OID.
A extensão deve sempre encaminhar essa solicitação de conjunto de OID para extensões subjacentes. A extensão não deve falhar na solicitação.
Depois que a solicitação de OID_SWITCH_PORT_DELETE for concluída com NDIS_STATUS_SUCCESS, a extensão não receberá pacotes ou solicitações OID para a porta excluída. A extensão não pode encaminhar pacotes para a porta excluída. A extensão também não pode emitir solicitações OID nem chamar a função ReferenceSwitchPort para a porta excluída.

Nota As extensões de comutador extensíveis não devem emitir solicitações de conjunto de OID de OID_SWITCH_PORT_DELETE.

Para obter mais informações sobre os estados de portas de comutador extensíveis e conexões de adaptador de rede, consulte Porta do Comutador Extensível do Hyper-V e Estados do Adaptador de Rede.

Códigos de status de retorno

A borda de miniporto subjacente do comutador extensível conclui a solicitação de conjunto de OID de OID_SWITCH_PORT_DELETE e retorna o código status a seguir.