OID_NIC_SWITCH_CREATE_VPORT

项目
06/15/2023

过分驱动程序发出对象标识符 (OID) 方法请求OID_NIC_SWITCH_CREATE_VPORT，以在网络适配器的 NIC 交换机上创建非默认虚拟端口 (VPort) 。此 OID 方法请求还会将创建的 VPort 附加到网络适配器的 PCI Express (PCIe) 物理功能 (PF) 或以前分配的 PCIe 虚拟函数 (VF) 。

过大驱动程序向网络适配器的 PF 的微型端口驱动程序发出此 OID 方法请求。支持单根 I/O 虚拟化 (SR-IOV) 接口的 PF 微型端口驱动程序需要此 OID 方法请求。

NDIS_OID_REQUEST 结构的 InformationBuffer 成员包含指向 NDIS_NIC_SWITCH_VPORT_PARAMETERS 结构的指针。

注解

overlying 驱动程序使用有关要创建的非默认 VPort 的配置信息初始化 NDIS_NIC_SWITCH_VPORT_PARAMETERS 结构。配置信息包括非默认 VPort 附加到的 PCIe 函数和非默认 VPort 的队列对数。

向 PF 微型端口驱动程序发出 OID 请求时，驱动程序将分配与指定的非默认 VPort 关联的硬件和软件资源。成功分配所有资源后，PF 微型端口驱动程序将通过从 MiniportOidRequest 返回NDIS_STATUS_SUCCESS成功完成 OID。

如果OID_NIC_SWITCH_CREATE_VPORT请求成功完成，则 PF 微型端口驱动程序和 overlying 驱动程序必须保留非默认 VPort 的 VPortId 值，以便连续操作。 VPortId 值在以下操作期间使用：

NDIS 和过度覆盖的驱动程序使用 VPortId 值来标识与此 VPort 相关的连续 OID 请求中的非默认 VPort，例如 OID_NIC_SWITCH_VPORT_PARAMETERS 和 OID_NIC_SWITCH_DELETE_VPORT。
在发送操作期间，NDIS 指定 VPortId 值以标识从中发送数据包的 VPort。此值在带外 (OOB) NDIS_NET_BUFFER_LIST_FILTERING_INFONET_BUFFER_LIST 结构的数据中指定。
在接收操作期间，PF 微型端口驱动程序指定要将数据包转发到的 VPortId 值。此值也是在 NET_BUFFER_LIST 结构的 OOB NDIS_NET_BUFFER_LIST_FILTERING_INFO 数据中指定的。

有关详细信息，请参阅创建虚拟端口。

注意默认 VPort 始终存在，并且不会通过OID_NIC_SWITCH_CREATE_VPORT的 OID 请求创建。默认 VPort 的标识符为 NDIS_DEFAULT_VPORT_ID。当 PF 微型端口驱动程序创建 NIC 交换机时，驱动程序会自动将默认 VPort 附加到网络适配器的 PF。

返回状态代码

NDIS 或 PF 微型端口驱动程序为 OID_NIC_SWITCH_CREATE_SWITCH 的 OID 方法请求返回以下状态代码之一。

状态代码	说明
NDIS_STATUS_SUCCESS	OID 请求已成功完成。
NDIS_STATUS_NOT_SUPPORTED	PF 微型端口驱动程序不支持 SR-IOV 接口，或者未启用该接口。
NDIS_STATUS_INVALID_PARAMETER	NDIS_NIC_SWITCH_VPORT_PARAMETERS 结构的一个或多个成员具有无效值。
NDIS_STATUS_INVALID_LENGTH	信息缓冲区的长度小于大小 (NDIS_NIC_SWITCH_VPORT_PARAMETERS) 。 PF 微型端口驱动程序必须设置 DATA。METHOD_INFORMATION。NDIS_OID_REQUEST结构中的 BytesNeeded 成员达到所需的最小缓冲区大小。
NDIS_STATUS_FAILURE	由于其他原因，请求失败。