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