OID_SWITCH_PORT_DELETE

A borda do protocolo do comutador extensível Hyper-V emite uma solicitação de conjunto OID (identificador de objeto) de OID_SWITCH_PORT_DELETE para notificar 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 de NDIS_SWITCH_PORT_PARAMETERS.

Observações

O portId membro da estrutura de 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 emitirá uma solicitação de conjunto de 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 do comutador extensível segue estas etapas quando exclui uma porta de comutador extensível:

1. A borda do protocolo do comutador extensível emite uma solicitação de conjunto de OID de OID_SWITCH_PORT_TEARDOWN. Essa solicitação OID notifica as extensíveis sobre o início do processo de exclusão para uma porta de comutador extensível.

2. 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 tiverem sido concluídas.

   Observação Se a extensão tiver chamado anteriormente ReferenceSwitchPort para incrementar o contador de referência da porta, ela deverá chamar DereferenceSwitchPort antes que a borda do protocolo emita a solicitação 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 OID_SWITCH_PORT_DELETE for concluída com NDIS_STATUS_SUCCESS, a extensão não receberá nenhum pacote ou solicitações de 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.

Observação extensíveis, as extensões de comutador 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 Hyper-V Extensible Switch Port and Network Adapter States.

Códigos de status de retorno

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

Requisitos

Consulte também

DereferenceSwitchPort

NDIS_OID_REQUEST

NDIS_SWITCH_PORT_PARAMETERS

NdisFOidRequest

OID_SWITCH_NIC_DELETE

OID_SWITCH_PORT_ARRAY

ReferenceSwitchPort