OID_SRIOV_SET_VF_POWER_STATE
Un controlador excesiva emite una solicitud de conjunto de identificador de objeto (OID) de OID_SRIOV_SET_VF_POWER_STATE para cambiar el estado de alimentación de una función virtual (VF) PCI Express (PCIe) especificada en el adaptador de red. Dado que el cambio del estado de alimentación es una operación con privilegios, los controladores de exceso emiten esta solicitud de conjunto de OID al controlador de minipuerto de la función física PCIe (PF) en el adaptador de red. A continuación, el controlador de minipuerto PF establece el estado de alimentación especificado en el VF.
El miembro InformationBuffer de la estructura NDIS_OID_REQUEST contiene un puntero a una estructura de NDIS_SRIOV_SET_VF_POWER_STATE_PARAMETERS .
Observaciones
Cuando el controlador de miniporte PF emite esta solicitud de conjunto de OID, debe seguir estas directrices:
El controlador de miniporte PF debe comprobar que el VF, especificado por el miembro VFId de la estructura NDIS_SRIOV_SET_VF_POWER_STATE_PARAMETERS , tiene recursos que se han asignado 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 el VF especificado no está en un estado asignado, el controlador debe producir un error en la solicitud OID.
La operación de estado de energía 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 Establecer el estado de energía de 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 de OID_SRIOV_SET_VF_POWER_STATE.
| Código de estado | Descripción |
|---|---|
NDIS_STATUS_SUCCESS |
La solicitud OID se completó correctamente. |
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_SRIOV_SET_VF_POWER_STATE_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. 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) |