OID_SRIOV_RESET_VF
在支持单根 I/O 虚拟化的网络适配器上重置指定的 PCI Express (PCIe) Virtual (Function) ， (OID) 集 OID_SRIOV_RESET_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 请求的通知，并将OID_SRIOV_RESET_VF的 OID 集请求发布到 PF 微型端口驱动程序。
处理此 OID 请求时，PF 微型端口驱动程序必须遵循以下准则：
PF 微型端口驱动程序必须验证由NDIS_SRIOV_RESET_VF_PARAMETERS结构的 VFId 成员指定的 VF 是否具有先前已分配的资源。 PF 微型端口驱动程序在OID_NIC_SWITCH_ALLOCATE_VF的 OID 方法请求期间为 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 微型端口驱动程序必须设置 DATA。SET_INFORMATION。NDIS_OID_REQUEST结构中的 BytesNeeded 成员达到所需的最小缓冲区大小。 |
NDIS_STATUS_FAILURE |
请求因其他原因而失败。 |
要求
版本 |
在 NDIS 6.30 及更高版本中受支持。 |
标头 |
Ntddndis.h (包括 Ndis.h) |