NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS 结构 (ntddndis.h)

  • 项目

NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS 结构指定对网络适配器的 PCI Express (PCIe) Virtual Function (VF) 的配置块执行读取操作的参数。 这些参数用于 VF 的微型端口驱动程序与 PCIe 物理函数 (PF) 之间的反向通道通信。

语法

typedef struct _NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS {
  NDIS_OBJECT_HEADER     Header;
  NDIS_SRIOV_FUNCTION_ID VFId;
  ULONG                  BlockId;
  ULONG                  Length;
  ULONG                  BufferOffset;
} NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS, *PNDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS;

成员

Header

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

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

NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS_REVISION_1

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

将 Size 成员设置为 NDIS_SIZEOF_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS_REVISION_1。

VFId

一个NDIS_SRIOV_FUNCTION_ID值，该值指定网络适配器上的 VF 的唯一标识符。

注意 具有指定NDIS_SRIOV_FUNCTION_ID值的 VF 必须具有以前通过 OID_NIC_SWITCH_ALLOCATE_VF 的 OID 方法请求分配的资源。
 

BlockId

一个 ULONG 值，该值指定要读取的 VF 配置块的标识符。 此标识符是独立硬件供应商 (IHV) 专有的，仅供网络适配器上 PF 和 VF 的微型端口驱动程序使用。

有关详细信息，请参见“备注”部分。

Length

一个 ULONG 值，该值指定读取操作的长度（以字节为单位）。

BufferOffset

一个 ULONG 值，该值指定从此结构的开头到包含从指定 VF 配置块读取数据的缓冲区的偏移量（以字节为单位）。

注解

NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS 结构用于OID_SRIOV_READ_VF_CONFIG_BLOCK的 OID 方法请求。

VF 配置块用于 PCIe PF 的驱动程序与支持 SR-IOV 接口的设备上的 VF 之间的反向通道通信。 VF 配置块中的数据可以在以下驱动程序之间交换：

  • VF 微型端口驱动程序，在来宾操作系统中运行。 此操作系统在 Hyper-V 子分区中运行。
  • 在管理操作系统中运行的 PF 微型端口驱动程序。

    此操作系统在 Hyper-V 父分区中运行。

注意 VF 配置块的用法及其配置数据的格式由设备的独立硬件供应商 (IHV) 定义。 配置数据仅由 PF 和 VF 微型端口驱动程序使用。
 
有关单根 I/O 虚拟化 (SR-IOV) 接口内反向通道通信的详细信息，请参阅 SR-IOV PF/VF 反向通道通信。

要求

要求 值
最低受支持的客户端 在 NDIS 6.30 及更高版本中受支持。
标头 ntddndis.h (包括 Ndis.h)

另请参阅

NDIS_OBJECT_HEADER

OID_SRIOV_READ_VF_CONFIG_BLOCK