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