OID_SRIOV_RESET_VF

过度分配驱动程序在支持单根 I/O 虚拟化的网络适配器上发出OID_SRIOV_RESET_VF的对象标识符(OID)集请求来重置指定的 PCI Express(PCIe) 虚拟函数(VF)。 过度分配驱动程序向网络适配器的 PCI Express(PCIe)物理功能(PF)的微型端口驱动程序发出此 OID 集请求。

NDIS_OID_REQUEST 结构的 InformationBuffer 成员包含指向 NDIS_SRIOV_RESET_VF_PARAMETERS 结构的指针。 过度配置驱动程序指定要通过此结构的 VFId 成员重置的 VF 的标识符。

言论

可以通过 PCI Express(PCIe)函数级别重置(FLR)重置 VF。 由于 FLR 请求是特权作,因此只能由在 Hyper-V 父分区的管理作系统中运行的 PF 微型端口驱动程序执行。 在管理作系统中运行的过度驱动程序会收到 FLR 请求的通知,并向 PF 微型端口驱动程序发出 OID 集OID_SRIOV_RESET_VF请求。

处理此 OID 请求时,PF 微型端口驱动程序必须遵循以下准则:

  • PF 微型端口驱动程序必须验证由 VFIdNDIS_SRIOV_RESET_VF_PARAMETERS 结构成员指定的 VF 是否具有以前分配的资源。 PF 微型端口驱动程序在 OID 方法请求 OID_NIC_SWITCH_ALLOCATE_VF期间为 VF 分配资源。 如果未分配指定 VF 的资源,驱动程序必须失败 OID 请求。

  • 重置作只能影响指定的 VF。 该作不得影响同一网络适配器上的其他 VF 或 PF。

有关详细信息,请参阅 重置虚拟函数

返回状态代码

PF 微型端口驱动程序为OID_SRIOV_RESET_VF集请求返回以下状态代码之一。

状态代码 描述

NDIS_STATUS_SUCCESS

OID 请求已成功完成。

NDIS_STATUS_NOT_SUPPORTED

PF 微型端口驱动程序要么不支持单个根 I/O 虚拟化(SR-IOV)接口,要么未启用该接口。

NDIS_STATUS_INVALID_PARAMETER

NDIS_SRIOV_RESET_VF_PARAMETERS 结构的一个或多个成员具有无效值。

NDIS_STATUS_INVALID_LENGTH

信息缓冲区太短。 PF 微型端口驱动程序必须设置 数据。SET_INFORMATION。NDIS_OID_REQUEST 结构中的 BytesNeeded 成员达到所需的最小缓冲区大小。

NDIS_STATUS_FAILURE

由于其他原因,请求失败。

要求

版本

NDIS 6.30 及更高版本中受支持。

页眉

Ntddndis.h (包括 Ndis.h)

另请参阅


NDIS_OID_REQUEST

NDIS_SRIOV_RESET_VF_PARAMETERS

OID_NIC_SWITCH_ALLOCATE_VF