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) |