OID_SWITCH_NIC_DISCONNECT

El borde del protocolo del Hyper-V conmutador extensible 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á descomponiéndose una conexión entre un puerto de conmutador extensible y un adaptador de red. Después de que la conexión se descomponga por completo, 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 index miembro 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 especificado Index está conectado al puerto de conmutador extensible especificado por el miembro PortId. Para obtener más información sobre estos valores de índice, vea valores de índice del adaptador de red.

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

• La extensión no debe modificar la estructura 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á anulando 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 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 llamada 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 OID.

  • Reenvío o origina 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 emitir el OID_SWITCH_NIC_DISCONNECT, la extensión todavía puede reenviar o originar indicaciones de estado 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 Hyper-V solicitudes OID de conmutador extensible. Después de que la extensión incremente 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 conjunto de OID a las extensiones subyacentes. La extensión no debe completar la solicitud.

• 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_DISCONNECT. 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 de índice, vea 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 los adaptadores de red físicos se pueden enlazar al adaptador de red externo, consulte 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_DISCONNECT.

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

Requisitos

Consulte también

NDIS_OID_REQUEST

NDIS_SWITCH_NIC_PARAMETERS

OID_SWITCH_NIC_DELETE

OID_SWITCH_PORT_ARRAY

ReferenceSwitchPort