OID_SRIOV_BAR_RESOURCES

Artículo
06/15/2023

NDIS emite una solicitud de método de identificador de objeto (OID) de OID_SRIOV_BAR_RESOURCES para determinar los recursos de memoria asignados a un registro de direcciones base de PCI Express (PCIe) (BAR) de una función virtual PCIe (VF).

NDIS emite 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 un búfer. Este búfer contiene las siguientes estructuras:

Estructura NDIS_SRIOV_BAR_RESOURCES_INFO que especifica el VF y BAR para el que el controlador de miniporte PF devuelve información de recursos.
Estructura CM_PARTIAL_RESOURCE_DESCRIPTOR que sigue a la estructura de NDIS_SRIOV_BAR_RESOURCES_INFO . La estructura CM_PARTIAL_RESOURCE_DESCRIPTOR contiene información sobre los recursos de memoria asignados a la barra especificada.

Observaciones

NDIS emite una solicitud de método OID de OID_SRIOV_BAR_RESOURCES para obtener la dirección física del sistema y la longitud de los recursos de memoria asignados a una barra de VF. Antes de que emite la solicitud del método OID, NDIS da formato a la estructura NDIS_SRIOV_BAR_RESOURCES_INFO de la siguiente manera:

NDIS establece el miembro VFId de la estructura de NDIS_SRIOV_BAR_RESOURCES_INFO en el identificador asociado al VF.
NDIS establece el miembro BarIndex de la estructura NDIS_SRIOV_BAR_RESOURCES_INFO en el índice BAR del VF especificado. El índice BAR es el desplazamiento del registro dentro de la tabla de BAR en el espacio de configuración pci.
NDIS establece el miembro BarResourcesOffset de la estructura NDIS_SRIOV_BAR_RESOURCES_INFO en el desplazamiento, en unidades de bytes, desde el principio de la estructura NDIS_SRIOV_BAR_RESOURCES_INFO a una estructura CM_PARTIAL_RESOURCE_DESCRIPTOR .

Nota Los controladores demasiado excesivos, como los controladores de protocolo o filtro, no pueden emitir solicitudes de método OID de OID_SRIOV_BAR_RESOURCES al controlador de miniporte PF.

Cuando el controlador de miniporte PF recibe la solicitud de método OID, el controlador devuelve los recursos de la barra especificada mediante el formato de la estructura CM_PARTIAL_RESOURCE_DESCRIPTOR dentro del miembro InformationBuffer de la estructura NDIS_OID_REQUEST . El controlador da formato a la estructura CM_PARTIAL_RESOURCE_DESCRIPTOR con los recursos de hardware del sistema asociados a la barra para el VF especificado.

Nota El controlador debe dar formato a la estructura de un tipo de recurso CmResourceTypeMemory.

Códigos de estado de devolución

El controlador de miniporte PF devuelve uno de los siguientes códigos de estado para la solicitud de método de OID_SRIOV_BAR_RESOURCES.

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_BAR_RESOURCES_INFO tienen valores no válidos.
NDIS_STATUS_INVALID_LENGTH	El búfer de información es menor que (sizeof(NDIS_SRIOV_BAR_RESOURCES_INFO) + sizeof(CM_PARTIAL_RESOURCE_DESCRIPTOR). 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

CM_PARTIAL_RESOURCE_DESCRIPTOR

NDIS_OID_REQUEST

NDIS_SRIOV_BAR_RESOURCES_INFO