NDIS_SRIOV_CAPABILITIES结构（ntddndis.h）

项目
02/07/2025

NDIS_SRIOV_CAPABILITIES 结构指定网络适配器的单个根 I/O 虚拟化（SR-IOV）功能。

语法

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

成员

Header

NDIS_SRIOV_CAPABILITIES 结构的类型、修订和大小。此成员的格式设置为 NDIS_OBJECT_HEADER 结构。

微型端口驱动程序必须将标头的类型成员设置为NDIS_OBJECT_TYPE_DEFAULT。若要指定 NDIS_SRIOV_CAPABILITIES 结构的版本，驱动程序必须将 Revision 成员标头设置为以下值：

NDIS_SRIOV_CAPABILITIES _REVISION_1

NDIS 6.30 及更高版本的原始版本。

将大小成员设置为NDIS_SIZEOF_SRIOV_CAPABILITIES _REVISION_1。

Flags

包含按位 OR 标志的 ULONG 值。此成员是为 NDIS 保留的

SriovCapabilities

包含以下标志的按位 OR 的 ULONG 值：

NDIS_SRIOV_CAPS_SRIOV_SUPPORTED

指定网络适配器支持 SR-IOV 功能。

注意此标志只能由网络适配器的 PCI Express（PCIe）物理功能（PF）的微型端口驱动程序设置。此驱动程序在管理作系统中运行。此作系统在 Hyper-V 父分区中运行。

NDIS_SRIOV_CAPS_PF_MINIPORT

指定这是 PF 微型端口驱动程序。

NDIS_SRIOV_CAPS_VF_MINIPORT

指定这是 PCIe 虚拟函数（VF）微型端口驱动程序。

言论

微型端口驱动程序使用 NDIS_SRIOV_CAPABILITIES 结构以下列方式报告其 SR-IOV 功能：

微型端口驱动程序从 MiniportInitializeEx 函数调用 NdisMSetMiniportAttributes 函数，并将 MiniportAttributes 参数设置为指向 NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES 结构的指针。驱动程序通过将 HardwareSriovCapabilities 和 CurrentSriovCapabilities 成员的格式设置为 NDIS_SRIOV_CAPABILITIES 结构来播发 SR-IOV 支持。
当驱动程序成功处理 OID_SRIOV_HARDWARE_CAPABILITIES 或 OID_SRIOV_CURRENT_CAPABILITIES的 OID 查询请求时，它将返回 NDIS_SRIOV_CAPABILITIES 结构。

NDIS 将网络适配器的 SR-IOV 功能传递给以以下方式绑定到网络适配器的过度驱动程序：

当 NDIS 调用过度的筛选器驱动程序 FilterAttach 函数时，NDIS 会通过 AttachParameters 参数传递网络适配器的 SR-IOV 功能。此参数包含指向 NDIS_FILTER_ATTACH_PARAMETERS 结构的指针。此结构的 SriovCapabilities 成员包含指向 NDIS_SRIOV_CAPABILITIES 结构的指针。
当 NDIS 调用过度分配的协议驱动程序的 ProtocolBindAdapterEx 函数时，NDIS 将通过 BindParameters 参数传递网络适配器的 SR-IOV 功能。此参数包含指向 NDIS_FILTER_ATTACH_PARAMETERS 结构的指针。此结构的 SriovCapabilities 成员包含指向 NDIS_SRIOV_CAPABILITIES 结构的指针。