OID_NIC_SWITCH_VPORT_PARAMETERS

Un controlador de sobreserción puede obtener los parámetros de un puerto virtual (VPort) en un conmutador NIC que se ha 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 un VPort especificado que está conectado 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 miniport 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 sobrepuesto especifica el VPort para el método OID o establecer la solicitud estableciendo el VPortId miembro de la estructura de NDIS_NIC_SWITCH_VPORT_PARAMETERS en el identificador asociado a VPort. El controlador de sobreserció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.

• Desde una solicitud de método OID anterior de OID_NIC_SWITCH_ENUM_VPORTS.

Observaciones

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

control de solicitudes de método OID de OID_NIC_SWITCH_VPORT_PARAMETERS

Los controladores excesivos emiten una solicitud de método OID de OID_NIC_SWITCH_VPORT_PARAMETERS para consultar los parámetros de configuración actuales de un VPort que está conectado al conmutador NIC del adaptador de red. Los controladores sobrepuestos especifican el VPort que se va a consultar estableciendo el VPortId miembro 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 miniport. NDIS devuelve información que obtuvo de solicitudes 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 informationBuffer miembro de la estructura de 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

Los controladores excesivos emiten 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 un 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:

1. El miembro VPortId se establece en el identificador de VPort cuyos parámetros se cambiarán.

2. 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 de_CHANGED Xxx NDIS_NIC_SWITCH_PARAMETERS_correspondiente en Ntddndis.h.

3. Los miembros correspondientes de la estructura de NDIS_NIC_SWITCH_VPORT_PARAMETERS se establecen con los parámetros de configuración de VPort que se van a cambiar.

Después de que el controlador de miniporte PF reciba 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 NDIS_NIC_SWITCH_VPORT_PARAMETERS_marcas 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 retorno

NDIS o el controlador de miniport pf devuelven el siguiente código de estado para solicitudes OID de conjunto o método de OID_NIC_SWITCH_VPORT_PARAMETERS.

Requisitos

Consulte también

NDIS_NIC_SWITCH_VPORT_PARAMETERS

NDIS_OID_REQUEST

OID_NIC_SWITCH_CREATE_VPORT

OID_NIC_SWITCH_ENUM_VPORTS