Compartilhar via


OID_SWITCH_NIC_DELETE

A borda do protocolo do comutador extensível Hyper-V emite uma solicitação de conjunto OID (identificador de objeto) de OID_SWITCH_NIC_DELETE para a pilha de driver de comutador extensível. Essa solicitação OID notifica as extensíveis sobre a exclusão de uma conexão entre uma porta de comutador extensível e um adaptador de rede. A borda do protocolo do comutador extensível notificou anteriormente extensões de que essa conexão está sendo excluída quando emitiu uma solicitação de conjunto de OID de OID_SWITCH_NIC_DISCONNECT.

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

Observações

O portId membro da estrutura NDIS_SWITCH_NIC_PARAMETERS especifica a porta para a qual a notificação de exclusão está sendo feita. A extensão de comutador extensível pode obter as informações de parâmetro para essa e outras portas na opção extensível, emitindo solicitações de consulta OID de OID_SWITCH_PORT_ARRAY.

O Index membro da estrutura NDIS_SWITCH_NIC_PARAMETERS especifica o índice de um adaptador de rede para o qual a notificação de exclusão está sendo feita. O adaptador de rede com o valor índice de especificado está conectado à porta de comutador extensível especificada pelo membro PortId. Para obter mais informações sobre esses valores de índice, consulte Valores de Índice do Adaptador de Rede.

Antes que a borda do protocolo do comutador extensível emita a solicitação OID_SWITCH_NIC_DELETE, ela garante que todas as solicitações de pacote de envio ou recebimento pendentes para a conexão do adaptador de rede especificada tenham sido concluídas. A borda do protocolo também garante que todas as solicitações OID pendentes para a conexão do adaptador tenham sido concluídas e os contadores de referência de comutador extensível para a conexão do adaptador tenham um valor zero.

Observação Se a extensão tiver incrementado um contador de referência de comutador extensível para o adaptador de rede chamando ReferenceSwitchNic, a solicitação OID_SWITCH_NIC_DELETE não será emitida enquanto o contador de referência não for zero. A extensão diminui o contador de referência de comutador extensível chamando DereferenceSwitchNic.

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

  • A extensão não deve modificar a estrutura de NDIS_SWITCH_NIC_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 concluir a solicitação.

  • A extensão não deve emitir suas próprias solicitações de conjunto de OID de OID_SWITCH_NIC_DELETE.

  • O adaptador de rede externa com comutador extensível pode ser associado a um ou mais adaptadores físicos subjacentes. Para cada adaptador de rede físico associado ao adaptador de rede externo, a borda do protocolo do comutador extensível emite uma solicitação de conjunto OID separada de OID_SWITCH_NIC_DELETE. Cada solicitação de conjunto de OID especifica um valor de índice de conexão de adaptador de rede diferente. Para obter mais informações sobre esses valores de índice, consulte Valores de Índice do Adaptador de Rede.

    A extensão deve manter o estado de conexão para cada adaptador físico subjacente. Para obter mais informações sobre as diferentes configurações nas quais os adaptadores de rede física podem ser associados ao adaptador de rede externo, consulte tipos de configurações de adaptador de rede física.

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 consulta OID de OID_SWITCH_NIC_DELETE e retorna o código de 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)

Consulte também


DereferenceSwitchNic

NDIS_OID_REQUEST

NDIS_SWITCH_NIC_PARAMETERS

OID_SWITCH_NIC_DISCONNECT

OID_SWITCH_PORT_ARRAY

referenceSwitchNic