OID_SWITCH_NIC_DISCONNECT

A borda de protocolo do switch extensível Hyper-V emite uma solicitação de conjunto de identificador de objeto (OID) de OID_SWITCH_NIC_DISCONNECT para notificar as extensões de switch extensíveis subjacentes de que uma conexão entre uma porta de switch extensível e um adaptador de rede está sendo derrubada. Depois que a conexão for completamente derrubada, a borda do protocolo do switch extensível emitirá uma solicitação de conjunto OID de OID_SWITCH_NIC_DELETE.

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

Comentários

O Index membro 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 especificado Index é conectado à porta do switch extensível especificada pelo membro PortId. Para obter mais informações sobre esses valores de índice, consulte Network Adapter Index Values.

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

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

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

  • Gere qualquer tráfego de pacotes para a conexão do adaptador de rede na porta do switch 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 switch extensível para a conexão do adaptador de rede especificado na porta do switch 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.

    Observação Se a extensão chamada ReferenceSwitchNic incrementar o contador de referência de switch 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 indicações de status NDIS 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.

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

    Observação Se a extensão chamada anteriormente ReferenceSwitchNic incrementar o contador de referência de switch extensível, ela não precisará sincronizar suas chamadas para originar ou encaminhar solicitações OID ou indicações de status NDIS com seu código que gerencia Hyper-V solicitações OID de switch extensível. Depois que a extensão incrementar o contador de referência, a interface do switch 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 OID para as extensões subjacentes. A prorrogação não deve completar o pedido.

• O adaptador de rede externo do switch extensível pode se ligar a um ou mais adaptadores físicos subjacentes. Para cada adaptador de rede físico que está vinculado ao adaptador de rede externo, a borda de protocolo do switch extensível emite uma solicitação de conjunto OID separada de OID_SWITCH_NIC_DISCONNECT. Cada solicitação de conjunto 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 Network Adapter Index Values.

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

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 consulta OID de OID_SWITCH_NIC_DISCONNECT e retorna o seguinte código de status.

Requerimentos

Ver também

NDIS_OID_REQUEST

NDIS_SWITCH_NIC_PARAMETERS

OID_SWITCH_NIC_DELETE

OID_SWITCH_PORT_ARRAY

ReferenceSwitchPort