OID_SWITCH_PORT_DELETE
El borde del protocolo del conmutador extensible de Hyper-V emite una solicitud de conjunto de identificador de objeto (OID) de OID_SWITCH_PORT_DELETE para notificar a las extensiones de conmutador extensible la eliminación de un puerto de conmutador extensible.
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 eliminación.
Si un adaptador de red está conectado al puerto especificado, el borde del protocolo del conmutador extensible eliminará la conexión antes de eliminar el puerto. En este caso, el perímetro del protocolo seguirá estos pasos antes de eliminar el puerto:
El perímetro del protocolo emite una solicitud de conjunto de OID de OID_SWITCH_NIC_DISCONNECT para notificar a la extensión que se está eliminando la conexión entre un adaptador de red y el puerto de conmutador extensible.
Una vez cancelados o completados todos los paquetes pendientes para el puerto de conmutador extensible especificado, el perímetro del protocolo emite una solicitud de conjunto de OID de OID_SWITCH_NIC_DELETE para notificar a la extensión que se ha eliminado la conexión entre un adaptador de red y el puerto de conmutador extensible.
En este momento, el borde del protocolo puede empezar a eliminar el puerto.
El borde del protocolo del conmutador extensible sigue estos pasos cuando elimina un puerto de conmutador extensible:
El borde del protocolo del conmutador extensible emite una solicitud de conjunto de OID de OID_SWITCH_PORT_TEARDOWN. Esta solicitud de OID notifica a las extensiones de conmutador extensible subyacentes el inicio del proceso de eliminación para un puerto de conmutador extensible.
El borde del protocolo emite una solicitud de conjunto de OID de OID_SWITCH_PORT_DELETE después de que se hayan completado todas las solicitudes de OID al puerto de conmutador extensible.
Nota Si la extensión había llamado anteriormente ReferenceSwitchPort para incrementar el contador de referencia del puerto, debe llamar a DereferenceSwitchPort antes de que el borde del protocolo emite la solicitud de OID_SWITCH_NIC_DELETE .
La extensión debe seguir estas instrucciones para controlar las solicitudes de conjunto de OID de OID_SWITCH_PORT_DELETE:
La extensión no debe modificar la estructura de NDIS_SWITCH_PORT_PARAMETERS asociada a la solicitud OID.
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.
Una vez completada la solicitud OID_SWITCH_PORT_DELETE con NDIS_STATUS_SUCCESS, la extensión no recibirá ningún paquete ni solicitudes de OID para el puerto eliminado. La extensión 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 Las extensiones de conmutador extensible no deben emitir solicitudes de conjunto de OID de OID_SWITCH_PORT_DELETE.
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_DELETE y devuelve el código de estado siguiente.
| Código de estado | Descripción |
|---|---|
NDIS_STATUS_SUCCESS |
La solicitud de OID se completó correctamente. |
Requisitos
Versión |
Se admite en NDIS 6.30 y versiones posteriores. |
Encabezado |
Ntddndis.h (incluye Ndis.h) |