OID_SRIOV_PROBED_BARS

NDIS (OID) 查询请求OID_SRIOV_PROBED_BARS发出对象标识符，以获取网络适配器的 PCI Express (PCIe) 基址寄存器 (BA) 的值。 此函数返回网络适配器在 PCI 总线驱动程序执行的查询后报告的 BAR 值。 此查询确定网络适配器所需的内存或 I/O 地址空间。

NDIS 向网络适配器的 PCIe 物理功能 (PF) 的微型端口驱动程序发出OID_SRIOV_PROBED_BARS的 OID 查询请求。 对于支持单根 I/O 虚拟化 (SR-IOV) 接口的 PF 微型端口驱动程序，需要此 OID 查询请求。

NDIS_OID_REQUEST 结构的 InformationBuffer 成员包含指向缓冲区的指针。 此缓冲区的格式设置为包含以下内容：

• 一个NDIS_SRIOV_PROBED_BARS_INFO结构，包含用于对网络适配器的 PCI BA 执行读取操作的参数。

• PCIe 网络适配器的每个 BAR 的 ULONG 值的数组。 此数组中的最大元素数为PCI_TYPE0_ADDRESSES。

注解

在 Hyper-V 父分区的管理操作系统中运行的 PCI 总线驱动程序查询网络适配器的每个 PCI 基址寄存器 (BAR) 的内存或 I/O 地址空间要求。 PCI 总线驱动程序在首次在总线上检测到适配器时执行此查询。

通过此 PCI BAR 查询，PCI 总线驱动程序确定以下内容：

• 网络适配器是否支持 PCI BAR。

• 如果支持 BAR，则 BAR 需要多少内存或 I/O 地址空间。

虚拟 PCI (VPCI) 总线驱动程序在 Hyper-V 子分区的来宾操作系统中运行。 将 PCI Express (PCIe) Virtual Function (VF) 附加到子分区时，VPCI 总线驱动程序将为 VF (VF 网络适配器) 公开虚拟网络适配器 。 在执行此操作之前，VPCI 总线驱动程序必须执行 PCI BAR 查询，以确定 VF 网络适配器所需的内存或地址空间。

由于对 PCI 配置空间的访问是一种特权操作，因此只能由 Hyper-V 父分区的管理操作系统中运行的组件执行。 当 VPCI 总线驱动程序查询 PCI BA 时，NDIS 向 PF 微型端口驱动程序发出OID_SRIOV_PROBED_BARS的 OID 查询请求。 此 OID 查询请求返回的结果将转发到 VPCI 总线驱动程序，以便它可以确定 VF 网络适配器需要多少内存地址空间。

注意 OID_SRIOV_PROBED_BARS的 OID 请求只能由 NDIS 发出。 OID 请求不得由过度分配驱动程序（例如筛选器驱动程序的协议）发出。

OID_SRIOV_PROBED_BARS查询请求包含 NDIS_SRIOV_PROBED_BARS_INFO 结构。 当 PF 微型端口驱动程序处理此 OID 时，驱动程序必须返回由 NDIS_SRIOV_PROBED_BARS_INFO 结构的 BaseRegisterValuesOffset 成员引用的数组中的 PCI BAR 值。 对于数组中的每个偏移量，PF 微型端口驱动程序必须将 array 元素设置为 BAR 的 ULONG 值，该偏移量与物理适配器的 PCI 配置空间中的偏移量相同。

驱动程序返回的每个 BAR 值必须与在管理操作系统中运行的 PCI 驱动程序执行的 PCI BAR 查询后面的值相同。 PF 微型端口驱动程序可以调用 NdisMQueryProbedBars 来确定此信息。

有关 PCI 设备的 BA 的详细信息，请参阅 PCI 本地总线规范。

有关如何查询 VF 的 PCI BAR 寄存器的详细信息，请参阅 查询虚拟函数的 PCI 基址寄存器。

返回状态代码

PF 微型端口驱动程序为OID_SRIOV_PROBED_BARS的查询请求返回以下状态代码之一：

要求

另请参阅

NDIS_OID_REQUEST

NDIS_SRIOV_PROBED_BARS_INFO

NdisMQueryProbedBars