OID_NIC_SWITCH_DELETE_VPORT

  • 项目

过度驱动程序发出对象标识符 (OID) 组请求OID_NIC_SWITCH_DELETE_VPORT删除以前在网络适配器的 NIC 交换机上创建的非默认虚拟端口 (VPort) 。 过度分配的驱动程序只能通过发出 OID 方法请求 （OID_NIC_SWITCH_CREATE_VPORT）来删除之前创建的 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_NIC_SWITCH_DELETE_VPORT的 OID 请求显式删除非默认 VPort。 当 PF 微型端口驱动程序删除默认 NIC 开关时，默认 VPort 将隐式删除。 有关详细信息，请参阅 删除 NIC 交换机。

返回状态代码

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

状态代码 说明

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

信息缓冲区的长度小于大小 (NDIS_NIC_SWITCH_DELETE_VPORT_PARAMETERS) 。 PF 微型端口驱动程序必须设置 DATA。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