Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
El borde del protocolo del Hyper-V conmutador extensible emite una solicitud de conjunto de identificador de objeto (OID) de OID_SWITCH_PORT_DELETE para notificar a las extensiones de conmutador extensible sobre 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 portId miembro 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 sobre el inicio del proceso de eliminación de 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 a 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 del conjunto de OID de OID_SWITCH_PORT_DELETE:
La extensión no debe modificar la estructura NDIS_SWITCH_PORT_PARAMETERS asociada a la solicitud OID.
La extensión siempre debe reenviar esta solicitud de conjunto 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 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 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 extensible y las conexiones del adaptador de red, consulte Hyper-V Los estados del adaptador de red y el puerto de conmutador extensible.
Códigos de estado de retorno
El borde de minipuerto subyacente del conmutador extensible completa la solicitud del conjunto de OID de OID_SWITCH_PORT_DELETE y devuelve el siguiente código de estado.
| Código de estado | Descripción |
|---|---|
NDIS_STATUS_SUCCESS |
La solicitud OID se completó correctamente. |
Requisitos
Versión |
Compatible con NDIS 6.30 y versiones posteriores. |
Encabezado |
Ntddndis.h (include Ndis.h) |