OID_NIC_SWITCH_VPORT_PARAMETERS

Artículo
06/15/2023

Un controlador de exceso puede obtener los parámetros de un puerto virtual (VPort) en un conmutador NIC creado en un adaptador de red que admita la virtualización de E/S raíz única (SR-IOV). El controlador emite una solicitud de método de identificador de objeto (OID) de OID_NIC_SWITCH_VPORT_PARAMETERS para obtener estos parámetros.

Los controladores excesivos emiten una solicitud de conjunto de OID de OID_NIC_SWITCH_VPORT_PARAMETERS para establecer los parámetros de configuración de una VPort especificada que está conectada al conmutador NIC del adaptador de red. Estas solicitudes de conjunto de OID se emiten al controlador de minipuerto de la función física (PF) del adaptador de red PCI Express (PCIe). Estas solicitudes de conjunto de OID son necesarias para los controladores de minipuerto PF que admiten la interfaz de virtualización de E/S raíz única (SR-IOV).

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

El controlador de sobreslización especifica la VPort para el método OID o establecer la solicitud estableciendo el miembro VPortId de la estructura de NDIS_NIC_SWITCH_VPORT_PARAMETERS en el identificador asociado a VPort. El controlador de sobrestitución obtiene el identificador VPort a través de una de las siguientes maneras:

A partir de una solicitud de método OID anterior de OID_NIC_SWITCH_CREATE_VPORT.
A partir de una solicitud de método OID anterior de OID_NIC_SWITCH_ENUM_VPORTS.

Observaciones

OID_NIC_SWITCH_VPORT_PARAMETERS se puede usar en solicitudes de método OID o en solicitudes de conjunto de OID.

Control de solicitudes de método OID de OID_NIC_SWITCH_VPORT_PARAMETERS

Los controladores excesivamente emiten una solicitud de método OID de OID_NIC_SWITCH_VPORT_PARAMETERS para consultar los parámetros de configuración actuales de una VPort que está conectada al conmutador NIC del adaptador de red. Los controladores que se sobreponen especifican la VPort que se va a consultar estableciendo el miembro VPortId de la estructura de NDIS_NIC_SWITCH_VPORT_PARAMETERS en el identificador VPort.

NDIS controla la solicitud de método OID de OID_NIC_SWITCH_VPORT_PARAMETERS para controladores de minipuerto. NDIS devuelve información que obtuvo de solicitudes de OID anteriores de OID_NIC_SWITCH_CREATE_VPORT y OID_NIC_SWITCH_ENUM_VPORTS.

Después de una devolución correcta de la solicitud del método OID, el miembro InformationBuffer de la estructura NDIS_OID_REQUEST contiene un puntero a una estructura de NDIS_NIC_SWITCH_VPORT_PARAMETERS . Esta estructura contiene los parámetros de configuración del modificador especificado.

Para obtener más información, consulte Consulta de los parámetros de un puerto virtual.

Control de solicitudes de conjunto de OID de OID_NIC_SWITCH_VPORT_PARAMETERS

El exceso de controladores emite una solicitud de conjunto de OID de OID_NIC_SWITCH_VPORT_PARAMETERS para cambiar los parámetros de configuración actuales de un VPort que está conectado al conmutador NIC de un adaptador de red. Esta solicitud de OID se puede usar para actualizar los parámetros de forma predeterminada, así como para VPorts no predeterminados.

Solo se puede cambiar un subconjunto limitado de parámetros de configuración para una VPort. El controlador de sobreslización especifica el parámetro que se va a cambiar estableciendo los siguientes miembros de la estructura de NDIS_NIC_SWITCH_VPORT_PARAMETERS :

El miembro VPortId se establece en el identificador de VPort cuyos parámetros se cambiarán.
Las marcas NDIS_NIC_SWITCH_VPORT_PARAMETERS_Xxx_CHANGED adecuadas se establecen en el miembro Flags . Los miembros de la estructura NDIS_NIC_SWITCH_VPORT_PARAMETERS solo se pueden cambiar si se define una marca NDIS_NIC_SWITCH_PARAMETERS_Xxx_CHANGED correspondiente en Ntddndis.h.
Los miembros correspondientes de la estructura NDIS_NIC_SWITCH_VPORT_PARAMETERS se establecen con los parámetros de configuración de VPort que se van a cambiar.

Una vez que el controlador de miniporte PF recibe la solicitud de conjunto de OID de OID_NIC_SWITCH_VPORT_PARAMETERS, el controlador configura el hardware con los parámetros de configuración. El controlador solo puede cambiar los parámetros de configuración identificados por las marcas NDIS_NIC_SWITCH_VPORT_PARAMETERS_Xxx_CHANGED en el miembro Flags de la estructura NDIS_NIC_SWITCH_VPORT_PARAMETERS .

Para obtener más información, vea Establecer los parámetros de un puerto virtual.

Códigos de estado de devolución

NDIS o el controlador de minipuerto PF devuelven el siguiente código de estado para las solicitudes OID de OID_NIC_SWITCH_VPORT_PARAMETERS.

Código de estado	Descripción
NDIS_STATUS_SUCCESS	La solicitud se completó correctamente. InformationBuffer apunta a una estructura de NDIS_NIC_SWITCH_CAPABILITIES.
NDIS_STATUS_NOT_SUPPORTED	El controlador de miniporte PF no admite la interfaz de virtualización de E/S raíz única (SR-IOV) o no está habilitada para usar la interfaz.
NDIS_STATUS_INVALID_PARAMETER	Uno o varios de los miembros de la estructura NDIS_NIC_SWITCH_VPORT_PARAMETERS tienen valores no válidos.
NDIS_STATUS_INVALID_LENGTH	El búfer de información era demasiado corto. NDIS o el controlador de miniporte PF establece data . METHOD_INFORMATION. Miembro BytesNeeded (para solicitudes de método OID) o DATA. SET_INFORMATION. Miembro BytesNeeded (para las solicitudes de conjunto de OID) en la estructura NDIS_OID_REQUEST en el tamaño mínimo del búfer necesario.
NDIS_STATUS_FAILURE	Error en la solicitud por otros motivos.