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