OID_NIC_SWITCH_VF_PARAMETERS

Artículo
06/14/2023

Una aplicación de modo de usuario o controlador sobreslizada emite una solicitud de método de identificador de objeto (OID) de OID_NIC_SWITCH_VF_PARAMETERS para obtener los parámetros de configuración actuales de una función virtual PCI Express (PCIe) en un adaptador de red. Solo se pueden consultar las máquinas virtuales que tienen recursos asignados a través de una solicitud de método OID de OID_NIC_SWITCH_ALLOCATE_VF a través de una solicitud de método OID de OID_NIC_SWITCH_VF_PARAMETERS.

NDIS controla la solicitud de método OID de OID_NIC_SWITCH_VF_PARAMETERS para controladores de minipuerto.

Cuando se realiza la solicitud de método OID, el miembro InformationBuffer de la estructura NDIS_OID_REQUEST contiene un puntero a una estructura de NDIS_NIC_SWITCH_VF_PARAMETERS .

Observaciones

La aplicación de modo de usuario o controlador sobrepuesto especifica el VF que se va a consultar estableciendo el miembro VFId de la estructura de NDIS_NIC_SWITCH_VF_PARAMETERS en el identificador del VF. El controlador o la aplicación que se sobreponen obtiene el identificador de VF a través de una de las siguientes maneras:

Mediante la emisión de una solicitud de método OID de OID_NIC_SWITCH_ENUM_VFS.

Si esta solicitud de OID se completa correctamente, la aplicación en modo de usuario o controlador excesiva recibe una lista de todas las máquinas virtuales asignadas en el adaptador de red. Cada elemento de la lista es una estructura NDIS_NIC_SWITCH_VF_INFO , con el identificador VF especificado por el miembro VFId .
Mediante la emisión de una solicitud de método OID de OID_NIC_SWITCH_ALLOCATE_VF.

Si esta solicitud de OID se completa correctamente, el controlador de sobreaprovisionamiento recibe el identificador del VF recién creado en el miembro VFId de la estructura de NDIS_NIC_SWITCH_VF_PARAMETERS devuelta.

Nota Solo los controladores que se sobreponen pueden obtener el identificador de VF de esta manera.

Después de una devolución correcta de la solicitud de método OID, el miembro InformationBuffer de la estructura NDIS_OID_REQUEST contiene un puntero a una estructura NDIS_NIC_SWITCH_VF_PARAMETERS . Esta estructura contiene los parámetros de configuración del VF especificado.

Códigos de estado de devolución

NDIS controla la solicitud de método OID de OID_NIC_SWITCH_VF_PARAMETERS para controladores de minipuerto y devuelve el código de estado siguiente para las solicitudes de método OID de OID_NIC_SWITCH_VF_PARAMETERS.

Código de estado	Descripción
NDIS_STATUS_SUCCESS	La solicitud se completó correctamente. El miembro InformationBuffer apunta a una estructura de NDIS_NIC_SWITCH_VF_PARAMETERS .
NDIS_STATUS_NOT_SUPPORTED	El controlador de minipuerto 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). NDIS establece data . METHOD_INFORMATION. Miembro BytesNeeded de la estructura NDIS_OID_REQUEST al tamaño mínimo del búfer necesario.
NDIS_STATUS_INVALID_LENGTH	El búfer de información era demasiado corto. NDIS establece 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.