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 demasiado excesivos emiten esta solicitud de conjunto de OID al controlador de miniporte 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 NDIS_SRIOV_RESET_VF_PARAMETERS. El controlador sobrepuesto especifica el identificador del VF que se va a restablecer a través del VFId miembro 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 del conjunto de OID de OID_SRIOV_RESET_VF al controlador de miniport pf.
Cuando controla esta solicitud de OID, el controlador de miniport pf debe seguir estas directrices:
El controlador de miniport pf debe comprobar que el VF, especificado por el VFId miembro de la estructura de NDIS_SRIOV_RESET_VF_PARAMETERS, tiene recursos asignados previamente. El controlador de miniporte 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 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, consulte Restablecer una función virtual.
Códigos de estado de retorno
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 OID se completó correctamente. |
NDIS_STATUS_NOT_SUPPORTED |
El controlador de miniport 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 el DATA. SET_INFORMATION. BytesNeeded miembro 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 |
Compatible con NDIS 6.30 y versiones posteriores. |
Encabezado |
Ntddndis.h (include Ndis.h) |