Compartilhar via


OID_SWITCH_NIC_DISCONNECT

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_NIC_DISCONNECT para notificar as extensões de comutador extensíveis subjacentes de que uma conexão entre uma porta de comutador extensível e um adaptador de rede está sendo interrompida. Depois que a conexão for completamente interrompida, a borda do protocolo da opção extensível emitirá uma solicitação de conjunto OID de OID_SWITCH_NIC_DELETE.

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

Comentários

O membro Index da estrutura NDIS_SWITCH_NIC_PARAMETERS especifica o índice de um adaptador de rede para o qual a notificação de desconexão está sendo feita. O adaptador de rede com o valor index 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.

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

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

  • A solicitação OID_SWITCH_NIC_DISCONNECT apenas notifica a extensão de que a conexão de comutador extensível está sendo interrompida entre o adaptador de rede especificado e a porta do comutador extensível. Depois que a extensão lida com essa solicitação de OID, ela não deve fazer o seguinte:

    • Gere qualquer tráfego de pacote para a conexão do adaptador de rede na porta do comutador extensível para a qual a solicitação OID OID_SWITCH_NIC_DISCONNECT foi emitida.

    • Chame ReferenceSwitchNic para incrementar o contador de referência de comutador extensível para a conexão do adaptador de rede especificada na porta do comutador extensível.

    • Encaminhar ou originar solicitações OID de OID_SWITCH_NIC_REQUEST para um adaptador de rede subjacente para o qual a solicitação OID OID_SWITCH_NIC_DISCONNECT foi emitida.

      Nota Se a extensão chamada ReferenceSwitchNic incrementar o contador de referência de comutador extensível antes que o OID_SWITCH_NIC_DISCONNECT seja emitido, a extensão ainda poderá encaminhar ou originar solicitações OID.

    • Encaminhar ou originar o NDIS status indicações de NDIS_STATUS_SWITCH_NIC_STATUS de um adaptador de rede subjacente para o qual a solicitação OID OID_SWITCH_NIC_DISCONNECT foi emitida.

      Nota Se a extensão chamada ReferenceSwitchNic incrementar o contador de referência de comutador extensível antes que o OID_SWITCH_NIC_DISCONNECT seja emitido, a extensão ainda poderá encaminhar ou originar indicações de NDIS status.

      Nota Se a extensão anteriormente chamada ReferenceSwitchNic incrementar o contador de referência de comutador extensível, ela não precisará sincronizar suas chamadas para originar ou encaminhar solicitações OID ou indicações de NDIS status com seu código que gerencia solicitações OID de comutador extensível do Hyper-V. Depois que a extensão incrementar o contador de referência, a interface de comutador extensível não emitirá uma solicitação de conjunto OID de OID_SWITCH_NIC_DELETE.

  • 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.

  • O adaptador de rede externa comutador extensível pode ser associado a um ou mais adaptadores físicos subjacentes. Para cada adaptador de rede física 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_DISCONNECT. Cada solicitação de conjunto de OID especifica um valor de índice de conexão do 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.

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

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 consulta OID de OID_SWITCH_NIC_DISCONNECT 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.

parâmetro

Ntddndis.h (inclua Ndis.h)

Confira também


NDIS_OID_REQUEST

NDIS_SWITCH_NIC_PARAMETERS

OID_SWITCH_NIC_DELETE

OID_SWITCH_PORT_ARRAY

ReferenceSwitchPort