OID_SWITCH_PORT_TEARDOWN

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_PORT_TEARDOWN para notificar a las extensiones de conmutador extensible subyacentes que un puerto de conmutador extensible iniciará el proceso de eliminación. Este proceso se inicia cuando el controlador de protocolo emite una solicitud de conjunto de OID de OID_SWITCH_PORT_DELETE.

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

Observaciones

El miembro PortId de la estructura NDIS_SWITCH_PORT_PARAMETERS especifica el puerto de conmutador extensible para el que se realiza la notificación de conexión. La extensión de conmutador extensible debe actualizar cualquier información almacenada en caché sobre el puerto que obtuvo 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 NET_PNP_EVENTnetEventSwitchActivate lo emite el miniporte de extensión.
Al inspeccionar las distintas solicitudes de conjuntos de OID de OID_SWITCH_PORT_CREATE y OID_SWITCH_PORT_DELETE.

El borde del protocolo del conmutador extensible emite una solicitud de conjunto de OID de OID_SWITCH_PORT_TEARDOWN para notificar a la extensión que un puerto está en proceso de eliminación del conmutador extensible. Antes de que se emita esta solicitud de OID, el borde del protocolo del conmutador extensible había emitido previamente los siguientes OID si el puerto tenía una conexión de adaptador de red activa:

OID_SWITCH_NIC_DISCONNECT, que notificó a las extensiones subyacentes que el adaptador de red ya no está conectado al puerto especificado en la estructura NDIS_SWITCH_PORT_PARAMETERS .
OID_SWITCH_NIC_DELETE, que notificó a las extensiones subyacentes que se ha eliminado la conexión de red entre el adaptador de red y el puerto de conmutador extensible.

El borde del protocolo emite esta solicitud de establecimiento de OID después de que se hayan cancelado o completado todos los paquetes pendientes para el puerto de conmutador extensible especificado.

Una vez que la extensión completa esta solicitud de conjunto de OID y el contador de referencia para el puerto de conmutador extensible es cero, el borde del protocolo del conmutador extensible emite una solicitud de conjunto de OID de OID_SWITCH_PORT_DELETE. Esta solicitud de OID elimina el puerto del conmutador extensible.

Nota Una extensión incrementa el contador de referencia de un puerto de conmutador extensible llamando a ReferenceSwitchPort. Una extensión disminuye el contador de referencia mediante una llamada a DereferenceSwitchPort.

La extensión debe seguir estas instrucciones para controlar las solicitudes de conjunto de OID de OID_SWITCH_PORT_TEARDOWN:

La extensión siempre debe reenviar esta solicitud de establecimiento de OID a las extensiones subyacentes. La extensión no debe producir un error en la solicitud.

Nota La extensión no debe modificar la estructura de NDIS_SWITCH_PORT_PARAMETERS asociada a la solicitud OID.
Una vez que la extensión reenvía esta solicitud de OID, no puede reenviar paquetes al puerto eliminado. La extensión tampoco puede emitir solicitudes OID ni llamar a la función ReferenceSwitchPort para el puerto eliminado.

Nota La extensión no debe emitir solicitudes de conjunto de OID de OID_SWITCH_PORT_TEARDOWN.

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 devolución

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