Compartir a través de


OID_SRIOV_RESET_VF

Los controladores excesivos emiten una solicitud de conjunto de identificador de objeto (OID) de OID_SRIOV_RESET_VF para restablecer una función virtual de PCI Express (PCIe) especificada en un adaptador de red que admita la virtualización de E/S raíz única. Los controladores excesivos emiten esta solicitud de establecimiento de OID al controlador de minipuerto de la función física PCI Express (PCIe) del adaptador de red.

El miembro InformationBuffer de la estructura NDIS_OID_REQUEST contiene un puntero a una estructura de NDIS_SRIOV_RESET_VF_PARAMETERS . El controlador de sobreajuste especifica el identificador del VF que se va a restablecer a través del miembro VFId de esta estructura.

Observaciones

Un VF se puede restablecer a través de un restablecimiento de nivel de función (FLR) PCI Express (PCIe). Dado que la solicitud FLR es una operación con privilegios, solo se puede realizar mediante el controlador de miniporte PF que se ejecuta en el sistema operativo de administración de una partición primaria de Hyper-V. Los controladores que se ejecutan en el sistema operativo de administración reciben una notificación de la solicitud FLR y emiten la solicitud de conjunto de OID de OID_SRIOV_RESET_VF al controlador de miniporte PF.

Cuando controla esta solicitud OID, el controlador de minipuerto PF debe seguir estas directrices:

  • El controlador de minipuerto PF debe comprobar que el VF, especificado por el miembro VFId de la estructura NDIS_SRIOV_RESET_VF_PARAMETERS , tiene recursos asignados previamente. El controlador de minipuerto PF asigna recursos para un VF durante una solicitud de método OID de OID_NIC_SWITCH_ALLOCATE_VF. Si no se han asignado recursos para el VF especificado, el controlador debe producir un error en la solicitud de OID.

  • La operación de restablecimiento solo debe afectar al VF especificado. La operación no debe afectar a otras máquinas virtuales ni al PF en el mismo adaptador de red.

Para obtener más información, vea Restablecer una función virtual.

Códigos de estado de devolución

El controlador de minipuerto PF devuelve uno de los siguientes códigos de estado para la solicitud de conjunto de OID_SRIOV_RESET_VF.

Código de estado Descripción

NDIS_STATUS_SUCCESS

La solicitud de OID se completó correctamente.

NDIS_STATUS_NOT_SUPPORTED

El controlador de minipuerto 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_SRIOV_RESET_VF_PARAMETERS tienen valores no válidos.

NDIS_STATUS_INVALID_LENGTH

El búfer de información era demasiado corto. El controlador de minipuerto PF debe establecer data . SET_INFORMATION. Miembro BytesNeeded de la estructura NDIS_OID_REQUEST al tamaño mínimo del búfer necesario.

NDIS_STATUS_FAILURE

Error en la solicitud por otros motivos.

Requisitos

Versión

Se admite en NDIS 6.30 y versiones posteriores.

Encabezado

Ntddndis.h (incluye Ndis.h)

Consulte también


NDIS_OID_REQUEST

NDIS_SRIOV_RESET_VF_PARAMETERS

OID_NIC_SWITCH_ALLOCATE_VF