OID_SWITCH_PORT_TEARDOWN

Hyper-V 可扩展交换机的协议边缘发出OID_SWITCH_PORT_TEARDOWN的对象标识符(OID)集请求,以通知基础可扩展交换机扩展,可扩展交换机端口将开始删除过程。 当协议驱动程序发出 OID 集OID_SWITCH_PORT_DELETE请求时,将启动此过程。

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

注解

NDIS_SWITCH_PORT_PARAMETERS结构的 PortId 成员指定正在为其发出连接通知的可扩展交换机端口。 可扩展交换机扩展必须更新其通过以下方式获取的端口的任何缓存信息:

  • 通过发出OID_SWITCH_PORT_ARRAYOID 查询请求。 仅当OID_SWITCH_PARAMETERS返回 IsActive 设置为 TRUE 的 NDIS_SWITCH_PARAMETERS 结构时,该扩展才会在 FilterAttach发出此 OID。 如果 IsActive 为 FALSE,则扩展在扩展微型端口发出 NetEventSwitchActivate NET_PNP_EVENT发出 OID。

  • 通过检查OID_SWITCH_PORT_CREATEOID_SWITCH_PORT_DELETE的各种 OID 集请求。

可扩展交换机的协议边缘发出OID_SWITCH_PORT_TEARDOWN的 OID 集请求,以通知扩展端口正在从可扩展交换机中删除。 发出此 OID 请求之前,如果端口具有活动网络适配器连接,可扩展交换机的协议边缘之前已发出以下 OID:

  • OID_SWITCH_NIC_DISCONNECT,它通知基础扩展网络适配器不再连接到NDIS_SWITCH_PORT_PARAMETERS结构中指定的端口。

  • OID_SWITCH_NIC_DELETE,它通知基础扩展已删除网络适配器和可扩展交换机端口之间的网络连接。

    协议边缘在已取消或完成指定可扩展交换机端口的所有挂起数据包后发出此 OID 集请求。

扩展完成此 OID 集请求并且可扩展交换机端口的引用计数器为零后,可扩展交换机的协议边缘会发出 OID 集请求 OID_SWITCH_PORT_DELETE。 此 OID 请求从可扩展交换机中删除端口。

请注意 ,扩展通过调用 ReferenceSwitchPort 递增可扩展交换机端口的引用计数器。 扩展通过调用 DereferenceSwitchPort 来递减引用计数器。

该扩展必须遵循以下准则来处理 OID 集OID_SWITCH_PORT_TEARDOWN请求:

  • 该扩展必须始终将此 OID 集请求转发到基础扩展。 扩展不能失败请求。

    请注意 ,该扩展不得修改 与 OID 请求关联的NDIS_SWITCH_PORT_PARAMETERS 结构。

  • 扩展转发此 OID 请求后,它无法将数据包转发到已删除的端口。 该扩展也不能发出 OID 请求,也不能为已删除的端口调用 ReferenceSwitchPort 函数。

请注意 ,该扩展不得发出OID_SWITCH_PORT_TEARDOWN的 OID 集请求。

有关可扩展交换机端口和网络适配器连接的状态的详细信息,请参阅 Hyper-V 可扩展交换机端口和网络适配器状态

返回状态代码

可扩展交换机的基础微型端口边缘完成OID_SWITCH_PORT_TEARDOWN的 OID 集请求,并返回以下状态代码。

状态代码 说明

NDIS_STATUS_SUCCESS

OID 请求已成功完成。

要求

版本

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

头文件

Ntddndis.h(包括 Ndis.h)

另请参阅


DereferenceSwitchPort

FilterAttach

NDIS_OID_REQUEST

NDIS_SWITCH_PARAMETERS

NDIS_SWITCH_PORT_PARAMETERS

NdisFOidRequest

NET_PNP_EVENT

OID_SWITCH_NIC_DELETE

OID_SWITCH_PARAMETERS

OID_SWITCH_PORT_ARRAY

ReferenceSwitchPort