OID_SWITCH_PORT_DELETE

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

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

Comentários

O PortId membro da estrutura NDIS_SWITCH_PORT_PARAMETERS especifica a porta do switch 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 switch 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 do switch extensível está sendo excluída.

• Depois que todos os pacotes pendentes para a porta de switch 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 do switch extensível foi excluída.

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

A borda do protocolo do switch extensível segue estas etapas quando exclui uma porta de switch extensível:

1. A borda de protocolo do switch extensível emite uma solicitação de conjunto OID de OID_SWITCH_PORT_TEARDOWN. Esta solicitação OID notifica as extensões de switch extensíveis subjacentes sobre o início do processo de exclusão de uma porta de switch 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 do switch extensível foram concluídas.

   Nota 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 de OID_SWITCH_NIC_DELETE.

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

• A extensão não deve modificar a estrutura de NDIS_SWITCH_PORT_PARAMETERS associada à solicitação OID.

• A extensão deve sempre encaminhar essa solicitação de conjunto OID para as extensões subjacentes. A prorrogação não deve falhar o pedido.

• Depois que a solicitação de OID_SWITCH_PORT_DELETE for concluída com NDIS_STATUS_SUCCESS, a extensão não receberá nenhum pacote ou solicitação 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 as extensões de switch extensível não devem emitir solicitações de conjunto OID de OID_SWITCH_PORT_DELETE.

Para obter mais informações sobre os estados das portas de switch 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 de miniporta subjacente do switch extensível conclui a solicitação de conjunto OID de OID_SWITCH_PORT_DELETE e retorna o seguinte código de status.

Requerimentos

Ver também

DereferenceSwitchPort

NDIS_OID_REQUEST

NDIS_SWITCH_PORT_PARAMETERS

NdisFOidRequest

OID_SWITCH_NIC_DELETE

OID_SWITCH_PORT_ARRAY

ReferenceSwitchPort