OID_NIC_SWITCH_ALLOCATE_VF
Un controlador excesivo emite una solicitud de método de identificador de objeto (OID) de OID_NIC_SWITCH_ALLOCATE_VF para asignar recursos para una función virtual PCI Express (PCIe) (VF). El VF se expone en un adaptador de red que admite la interfaz de virtualización de E/S raíz única (SR-IOV).
Los controladores excesivos emiten esta solicitud de método OID al controlador de minipuerto para la función física PCIe (PF) del adaptador de red. Esta solicitud de método OID es necesaria para los controladores de minipuerto 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 NDIS_NIC_SWITCH_VF_PARAMETERS .
Observaciones
El controlador de minipuerto PF asigna recursos de software para un VF cuando el controlador controla una solicitud de método de identificador de objeto (OID) de OID_NIC_SWITCH_ALLOCATE_VF. Aunque los recursos de hardware se han asignado para un VF, se considera no operativo hasta que el controlador de miniporte PF complete correctamente la OID_NIC_SWITCH_ALLOCATE_VF.
Para obtener más información sobre cómo asignar recursos de VF, consulte Asignación de recursos para una función virtual.
Nota Después de que un controlador sobreasignación de recursos solicita la asignación de recursos para un VF, ese controlador es el único componente que puede solicitar la liberación de los recursos para la misma VF. El controlador de sobreaprovisionamiento debe emitir una solicitud de conjunto de OID de OID_NIC_SWITCH_FREE_VF para liberar los recursos de VF. Antes de que se pueda detener el controlador de sobreasignación, debe liberar los recursos de cada VF asignado por la solicitud de OID_NIC_SWITCH_ALLOCATE_VF del controlador.
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 método OID de OID_NIC_SWITCH_ALLOCATE_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_NIC_SWITCH_VF_PARAMETERS tienen valores no válidos. |
NDIS_STATUS_INVALID_LENGTH |
La longitud del búfer de información es menor que sizeof(NDIS_NIC_SWITCH_VF_PARAMETERS). El controlador de minipuerto PF debe establecer data . METHOD_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) |