NDIS_SRIOV_CAPABILITIES 结构 (ntddndis.h)

项目
08/07/2023

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 结构。

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

NDIS_SRIOV_CAPABILITIES _REVISION_1

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

将 Size 成员设置为 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 结构的指针。