Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
A borda do protocolo do comutador extensível Hyper-V emite uma solicitação de conjunto OID (identificador de objeto) de OID_SWITCH_NIC_CONNECT para notificar as extensões de comutador extensíveis subjacentes de que uma conexão de rede entre uma porta de comutador extensível e um adaptador de rede está completamente estabelecida. A borda do protocolo notificou anteriormente extensões de que essa conexão está sendo estabelecida quando emitiu uma solicitação de conjunto de OID de OID_SWITCH_NIC_CREATE.
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 de comutador extensível para a qual a notificação de conexão está sendo feita. A extensão de comutador extensível pode obter as informações de parâmetro para essa porta e outras portas de comutador extensíveis das seguintes maneiras:
Emitindo solicitações de consulta OID de OID_SWITCH_PORT_ARRAY. A extensão emite essa OID no FilterAttach somente quando OID_SWITCH_PARAMETERS retorna uma estrutura NDIS_SWITCH_PARAMETERS com IsActive definido como TRUE. Se IsActive for FALSE, a extensão emitirá o OID quando o NET_PNP_EVENTNetEventSwitchActivate for emitido pelo adaptador de miniporto de extensão.
Inspecionando as várias solicitações de conjuntos de OID de OID_SWITCH_PORT_CREATE e OID_SWITCH_PORT_DELETE.
O Index membro da estrutura NDIS_SWITCH_NIC_PARAMETERS especifica o índice de um adaptador de rede para o qual a notificação de conexã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.
Quando ele recebe a solicitação de conjunto OID de OID_SWITCH_NIC_CONNECT, a extensão deve seguir estas diretrizes:
Quando a solicitação OID_SWITCH_NIC_CONNECT for concluída com NDIS_STATUS_SUCCESS, a conexão de rede e a porta de comutador extensível estarão totalmente operacionais. A extensão pode gerar ou encaminhar o tráfego de pacotes para a conexão de rede da porta. A extensão também pode emitir OIDs de comutador extensíveis ou indicações de status que usam a porta como porta de origem. A extensão também pode chamar ReferenceSwitchPort para incrementar o contador de referência de comutador extensível para a porta.
A extensão não deve modificar a estrutura de NDIS_SWITCH_NIC_PARAMETERS associada à solicitação OID.
A extensão deve sempre chamar NdisFOidRequest para encaminhar essa solicitação OID para extensões subjacentes. A extensão não deve concluir a solicitação OID em si.
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_CONNECT. 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, consulte valores de índice do adaptador de rede.
A extensão deve manter o estado de conexão para cada adaptador físico subjacente associado ao adaptador de rede externo. 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.
Observação A extensão não deve emitir suas próprias solicitações de conjunto de OID de OID_SWITCH_NIC_CONNECT.
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 do conjunto de OID de OID_SWITCH_NIC_CONNECT 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) |