estructura NDIS_SRIOV_CAPABILITIES (ntddndis.h)

Artículo
02/07/2025

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 el formato de una estructura NDIS_OBJECT_HEADER.

El controlador de miniport debe establecer el miembro Type de Encabezado 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 Encabezado en el siguiente valor:

NDIS_SRIOV_CAPABILITIES _REVISION_1

Versión original para NDIS 6.30 y versiones posteriores.

Establezca el miembro tamaño de 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 SR-IOV funcionalidad.

Nota Esta marca solo debe establecerse mediante el controlador de miniport 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 Hyper-V.

NDIS_SRIOV_CAPS_PF_MINIPORT

Especifica que se trata de un controlador de miniporte PF.

NDIS_SRIOV_CAPS_VF_MINIPORT

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

Observaciones

El controlador de miniporte usa la estructura NDIS_SRIOV_CAPABILITIES para informar de sus funcionalidades de SR-IOV de las siguientes maneras:

El controlador de miniport llama a la función NdisMSetMiniportAttributes desde su función MiniportInitializeEx y establece el parámetro MiniportAttributes en un puntero a una estructura de NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES. El controlador anuncia SR-IOV compatibilidad con el formato de los 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 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 de filtro filterAttach, NDIS pasa las funcionalidades de SR-IOV del adaptador de red a través del parámetro AttachParameters. Este parámetro contiene un puntero a una estructura NDIS_FILTER_ATTACH_PARAMETERS. El SriovCapabilities miembro de esta estructura contiene un puntero a una estructura NDIS_SRIOV_CAPABILITIES.
Cuando NDIS llama a la función ProtocolBindAdapterEx de un controlador de protocolo excesivo, NDIS pasa las funcionalidades de SR-IOV del adaptador de red a través del parámetro BindParameters. Este parámetro contiene un puntero a una estructura NDIS_FILTER_ATTACH_PARAMETERS. El SriovCapabilities miembro de esta estructura contiene un puntero a una estructura NDIS_SRIOV_CAPABILITIES.