OID_SWITCH_NIC_CONNECT

Artículo
06/15/2023

El borde del protocolo del conmutador extensible de Hyper-V emite una solicitud de conjunto de identificador de objeto (OID) de OID_SWITCH_NIC_CONNECT para notificar a las extensiones de conmutador extensible subyacentes que se establece completamente una conexión de red entre un puerto de conmutador extensible y un adaptador de red. El perímetro del protocolo ha notificado previamente extensiones que esta conexión se está estableciendo cuando emitió una solicitud de conjunto de OID de OID_SWITCH_NIC_CREATE.

El miembro InformationBuffer de la estructura NDIS_OID_REQUEST contiene un puntero a una estructura de NDIS_SWITCH_NIC_PARAMETERS .

Comentarios

El miembro PortId de la estructura NDIS_SWITCH_NIC_PARAMETERS especifica el puerto de conmutador extensible para el que se realiza la notificación de conexión. La extensión de conmutador extensible puede obtener la información de parámetros de este puerto y otros puertos de conmutador extensible de las siguientes maneras:

Mediante la emisión de solicitudes de consulta de OID de OID_SWITCH_PORT_ARRAY. La extensión emite este OID en FilterAttach solo cuando OID_SWITCH_PARAMETERS devuelve una estructura de NDIS_SWITCH_PARAMETERS con IsActive establecido en TRUE. Si IsActive es FALSE, la extensión emite el OID cuando el adaptador de miniporte de extensión emite el NET_PNP_EVENT NetEventSwitchActivate.
Al inspeccionar las distintas solicitudes de conjuntos de OID de OID_SWITCH_PORT_CREATE y OID_SWITCH_PORT_DELETE.

El miembro Index de la estructura NDIS_SWITCH_NIC_PARAMETERS especifica el índice de un adaptador de red para el que se realiza la notificación de conexión. El adaptador de red con el valor index especificado está conectado al puerto de conmutador extensible especificado por el miembro PortId. Para obtener más información sobre estos valores de índice, consulte Valores de índice del adaptador de red.

Cuando recibe la solicitud de conjunto de OID de OID_SWITCH_NIC_CONNECT, la extensión debe seguir estas instrucciones:

Cuando la solicitud de OID_SWITCH_NIC_CONNECT se completa con NDIS_STATUS_SUCCESS, la conexión de red y el puerto de conmutador extensible están totalmente operativos. La extensión puede generar o reenviar el tráfico de paquetes a la conexión de red del puerto. La extensión también puede emitir OID de conmutador extensible o indicaciones de estado que usan el puerto como puerto de origen. La extensión también puede llamar a ReferenceSwitchPort para incrementar el contador de referencia de conmutador extensible para el puerto.
La extensión no debe modificar la estructura NDIS_SWITCH_NIC_PARAMETERS asociada a la solicitud OID.
La extensión siempre debe llamar a NdisFOidRequest para reenviar esta solicitud de OID a las extensiones subyacentes. La extensión no debe completar la propia solicitud OID.
El adaptador de red externo del conmutador extensible puede enlazarse a uno o varios adaptadores físicos subyacentes. Para cada adaptador de red físico enlazado al adaptador de red externo, el borde del protocolo del conmutador extensible emite una solicitud de conjunto de OID independiente de OID_SWITCH_NIC_CONNECT. Cada solicitud de conjunto de OID especifica un valor de índice de conexión de adaptador de red diferente. Para obtener más información sobre estos valores, consulte Valores de índice del adaptador de red.

La extensión debe mantener el estado de conexión de cada adaptador físico subyacente enlazado al adaptador de red externo. Para obtener más información sobre las distintas configuraciones en las que los adaptadores de red físicos se pueden enlazar al adaptador de red externo, vea Tipos de configuraciones de adaptadores de red físicos.

Nota La extensión no debe emitir sus propias solicitudes de conjunto de OID de OID_SWITCH_NIC_CONNECT.

Para obtener más información sobre los estados de los puertos de conmutador extensibles y las conexiones del adaptador de red, consulte Puerto de conmutador extensible de Hyper-V y Estados del adaptador de red.

Códigos de estado de retorno

El borde de minipuerto subyacente del conmutador extensible completa la solicitud del conjunto de OID de OID_SWITCH_NIC_CONNECT y devuelve el código de estado siguiente.