estructura NDIS_SRIOV_CAPABILITIES (ntddndis.h)

Artículo
03/05/2024

La estructura NDIS_SRIOV_CAPABILITIES especifica las funcionalidades de virtualización de E/S raíz única (SR-IOV) del adaptador de red.

Sintaxis

typedef struct _NDIS_SRIOV_CAPABILITIES {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  ULONG              SriovCapabilities;
} NDIS_SRIOV_CAPABILITIES, *PNDIS_SRIOV_CAPABILITIES;

Miembros

Header

Tipo, revisión y tamaño de la estructura NDIS_SRIOV_CAPABILITIES . Este miembro tiene formato de estructura NDIS_OBJECT_HEADER .

El controlador de minipuerto debe establecer el miembro Type de Header en NDIS_OBJECT_TYPE_DEFAULT. Para especificar la versión de la estructura de NDIS_SRIOV_CAPABILITIES , el controlador debe establecer el miembro Revision de Header en el siguiente valor:

NDIS_SRIOV_CAPABILITIES _REVISION_1

Versión original para NDIS 6.30 y versiones posteriores.

Establezca el miembro Size en NDIS_SIZEOF_SRIOV_CAPABILITIES _REVISION_1.

Flags

Valor de ULONG que contiene un OR bit a bit de marcas. Este miembro está reservado para NDIS

SriovCapabilities

Valor de ULONG que contiene un OR bit a bit de las marcas siguientes:

NDIS_SRIOV_CAPS_SRIOV_SUPPORTED

Especifica que el adaptador de red admite la funcionalidad SR-IOV.

Nota Esta marca solo debe establecerse mediante el controlador de minipuerto para la función física PCI Express (PCIe) del adaptador de red. Este controlador se ejecuta en el sistema operativo de administración. Este sistema operativo se ejecuta en la partición primaria de Hyper-V.

NDIS_SRIOV_CAPS_PF_MINIPORT

Especifica que se trata de un controlador de minipuerto PF.

NDIS_SRIOV_CAPS_VF_MINIPORT

Especifica que se trata de un controlador de minipuerto de función virtual PCIe (VF).

Comentarios

El controlador de minipuerto usa la estructura de NDIS_SRIOV_CAPABILITIES para notificar sus funcionalidades sr-IOV de las siguientes maneras:

El controlador de minipuerto llama a la función NdisMSetMiniportAttributes desde su función MiniportInitializeEx y establece el parámetro MiniportAttributes en un puntero a una estructura NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES . El controlador anuncia la compatibilidad con SR-IOV mediante el formato de los miembros HardwareSriovCapabilities y CurrentSriovCapabilities como estructuras de NDIS_SRIOV_CAPABILITIES .
Cuando el controlador controla correctamente una solicitud de consulta OID de OID_SRIOV_HARDWARE_CAPABILITIES o OID_SRIOV_CURRENT_CAPABILITIES, devuelve una estructura de NDIS_SRIOV_CAPABILITIES .

NDIS pasa las funcionalidades de SR-IOV del adaptador de red a los controladores que se enlazan al adaptador de red de la siguiente manera:

Cuando NDIS llama a una función FilterAttach del controlador de filtro excesiva, NDIS pasa las funcionalidades sr-IOV del adaptador de red a través del parámetro AttachParameters . Este parámetro contiene un puntero a una estructura de NDIS_FILTER_ATTACH_PARAMETERS . El miembro SriovCapabilities de esta estructura contiene un puntero a una estructura de NDIS_SRIOV_CAPABILITIES .
Cuando NDIS llama a una función ProtocolBindAdapterEx del controlador de protocolo excesivo, NDIS pasa las funcionalidades sr-IOV del adaptador de red a través del parámetro BindParameters . Este parámetro contiene un puntero a una estructura de NDIS_FILTER_ATTACH_PARAMETERS . El miembro SriovCapabilities de esta estructura contiene un puntero a una estructura de NDIS_SRIOV_CAPABILITIES .