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)

Consulte también


NDIS_MAKE_RID

OID_NIC_SWITCH_CREATE_SWITCH

OID_NIC_SWITCH_CREATE_VPORT

NDIS_NIC_SWITCH_VF_PARAMETERS

OID_NIC_SWITCH_FREE_VF