OID_SWITCH_PORT_DELETE
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.
| Código de status | Descrição |
|---|---|
NDIS_STATUS_SUCCESS |
A solicitação OID foi concluída com êxito. |
Requisitos
Versão |
Com suporte no NDIS 6.30 e posterior. |
Cabeçalho |
Ntddndis.h (inclua Ndis.h) |