OID_NIC_SWITCH_DELETE_VPORT

过度的驱动程序发出OID_NIC_SWITCH_DELETE_VPORT的对象标识符(OID)集请求,以删除以前在网络适配器的 NIC 交换机上创建的非默认虚拟端口(VPort)。 过度的驱动程序可以通过发出 OID_NIC_SWITCH_CREATE_VPORT的 OID 方法请求来删除以前创建的 VPort。

过度分配驱动程序向网络适配器的 PCIe 物理功能(PF)的微型端口驱动程序发出此 OID 集请求。 支持单个根 I/O 虚拟化(SR-IOV)接口的 PF 微型端口驱动程序需要此 OID 集请求。

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

言论

过度的驱动程序(如协议或筛选器驱动程序)只能删除以前创建的非默认 VPort。 过度的驱动程序通过发出 OID_NIC_SWITCH_CREATE_VPORT的 OID 方法请求来创建 VPort。

当 PF 微型端口驱动程序收到 OID_NIC_SWITCH_DELETE_VPORT 的 OID 请求时,驱动程序必须释放为指定 VPort 分配的硬件和软件资源。

有关详细信息,请参阅 删除虚拟端口

注意 只能通过 OID 请求显式删除非默认 VPorts OID_NIC_SWITCH_DELETE_VPORT。 当 PF 微型端口驱动程序删除默认 NIC 开关时,将隐式删除默认 VPort。 有关详细信息,请参阅 删除 NIC 交换机

返回状态代码

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

状态代码 描述

NDIS_STATUS_SUCCESS

OID 请求已成功完成。

NDIS_STATUS_NOT_SUPPORTED

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

NDIS_STATUS_INVALID_PARAMETER

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

NDIS_STATUS_INVALID_LENGTH

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

NDIS_STATUS_FAILURE

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

要求

版本

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

页眉

Ntddndis.h (包括 Ndis.h)

另请参阅


NDIS_NIC_SWITCH_DELETE_VPORT_PARAMETERS

NDIS_OID_REQUEST

NdisCloseAdapterEx

OID_NIC_SWITCH_CREATE_VPORT

OID_NIC_SWITCH_DELETE_SWITCH