OID_SWITCH_NIC_UPDATED

El borde del protocolo del conmutador extensible de Hyper-V emite una solicitud de conjunto de identificador de objeto (OID) de OID_SWITCH_NIC_UPDATED a la pila de controladores de conmutador extensible. Esta solicitud de OID notifica a las extensiones de conmutador extensible subyacentes sobre la actualización de los parámetros de un adaptador de red. El OID solo se emitirá para las NIC que ya se han conectado y aún no han comenzado el proceso de desconexión. Estos cambios de configuración en tiempo de ejecución pueden incluir NicFriendlyName, NetCfgInstanceId, MTU, NumaNodeId, PermanentMacAddress, VMMacAddress, CurrentMacAddress y VFAssigned.

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

Observaciones

El miembro PortId de la estructura NDIS_SWITCH_NIC_PARAMETERS especifica el puerto para el que se realiza la notificación de actualización. La extensión de conmutador extensible puede obtener la información de parámetros de este y otros puertos en el conmutador extensible mediante la emisión de solicitudes de consulta OID de OID_SWITCH_PORT_ARRAY.

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 actualizació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 para controlar las solicitudes de conjunto de OID de OID_SWITCH_NIC_UPDATED:

  • La extensión no debe modificar la estructura de NDIS_SWITCH_NIC_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 completar la solicitud.
  • La extensión no debe emitir sus propias solicitudes de conjunto de OID de OID_SWITCH_NIC_UPDATED.

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_UPDATED 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)

Consulte también


DereferenceSwitchNic

NDIS_OID_REQUEST

NDIS_SWITCH_NIC_PARAMETERS

OID_SWITCH_NIC_DISCONNECT

OID_SWITCH_PORT_ARRAY

ReferenceSwitchNic