OID_SWITCH_NIC_DISCONNECT

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_DISCONNECT para notificar a las extensiones de conmutador extensible subyacentes que se está desconectando una conexión entre un puerto de conmutador extensible y un adaptador de red. Una vez que la conexión está completamente desactivada, el borde del protocolo del conmutador extensible emitirá una solicitud de conjunto de OID de OID_SWITCH_NIC_DELETE.

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

Observaciones

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 desconexión. El adaptador de red con el valor de Índice 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.

La extensión debe seguir estas instrucciones cuando controla las solicitudes de conjunto de OID de OID_SWITCH_NIC_DISCONNECT:

La extensión no debe modificar la estructura de NDIS_SWITCH_NIC_PARAMETERS asociada a la solicitud OID.
La solicitud de OID_SWITCH_NIC_DISCONNECT solo notifica a la extensión que la conexión de conmutador extensible se está desconectando entre el adaptador de red especificado y el puerto de conmutador extensible. Una vez que la extensión controla esta solicitud de OID, no debe hacer lo siguiente:
- Genere cualquier tráfico de paquetes a la conexión del adaptador de red en el puerto de conmutador extensible para el que se emitió la solicitud de OID de OID_SWITCH_NIC_DISCONNECT.
- Llame a ReferenceSwitchNic para incrementar el contador de referencia de conmutador extensible para la conexión del adaptador de red especificada en el puerto de conmutador extensible.
- Reenviar o originar solicitudes de OID de OID_SWITCH_NIC_REQUEST a un adaptador de red subyacente para el que se emitió la solicitud de OID de OID_SWITCH_NIC_DISCONNECT.
  
  Nota Si la extensión denominada ReferenceSwitchNic para incrementar el contador de referencia de conmutador extensible antes de que se emita el OID_SWITCH_NIC_DISCONNECT, la extensión todavía puede reenviar o originar solicitudes de OID.
- Reenviar o originar indicaciones de estado de NDIS de NDIS_STATUS_SWITCH_NIC_STATUS de un adaptador de red subyacente para el que se emitió la solicitud de OID de OID_SWITCH_NIC_DISCONNECT.
  
  Nota Si la extensión denominada ReferenceSwitchNic para incrementar el contador de referencia de conmutador extensible antes de que se emita el OID_SWITCH_NIC_DISCONNECT, la extensión todavía puede reenviar o originar indicaciones de estado de NDIS.
  
  Nota Si la extensión anteriormente llamada ReferenceSwitchNic para incrementar el contador de referencia de conmutador extensible, no es necesario sincronizar sus llamadas para originar o reenviar solicitudes de OID o indicaciones de estado de NDIS con su código que administra las solicitudes OID de conmutador extensible de Hyper-V. Una vez que la extensión incrementa el contador de referencia, la interfaz de conmutador extensible no emitirá una solicitud de conjunto de OID de OID_SWITCH_NIC_DELETE.
La extensión siempre debe reenviar esta solicitud de establecimiento de OID a las extensiones subyacentes. La extensión no debe completar la solicitud.
El adaptador de red externo de 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_DISCONNECT. Cada solicitud de conjunto de OID especifica un valor de índice de conexión del adaptador de red diferente. Para obtener más información sobre estos valores de índice, consulte Valores de índice del adaptador de red.

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

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

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 consulta OID de OID_SWITCH_NIC_DISCONNECT y devuelve el código de estado siguiente.