OID_SWITCH_PORT_TEARDOWN
Hyper-V 可扩展交换机的协议边缘发出对象标识符 (OID) OID_SWITCH_PORT_TEARDOWN集请求,以通知基础可扩展交换机扩展,可扩展交换机端口将开始删除过程。 当协议驱动程序发出 OID_SWITCH_PORT_DELETE的 OID 集请求时,将启动此过程。
NDIS_OID_REQUEST 结构的 InformationBuffer 成员包含指向NDIS_SWITCH_PORT_PARAMETERS结构的指针。
注解
NDIS_SWITCH_PORT_PARAMETERS 结构的 PortId 成员指定要为其发出连接通知的可扩展交换机端口。 可扩展交换机扩展必须按以下方式更新其获取的端口的任何缓存信息:
通过发出 OID_SWITCH_PORT_ARRAY的 OID 查询请求。 仅当 OID_SWITCH_PARAMETERS 返回 IsActive 设置为 TRUE 的NDIS_SWITCH_PARAMETERS结构时,扩展才会在 FilterAttach 上发出此 OID。 如果 IsActive 为 FALSE,则当 NetEventSwitchActivateNET_PNP_EVENT 由扩展微型端口发出时,扩展会发出 OID。
通过检查 OID_SWITCH_PORT_CREATE 和 OID_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_SWITCH_PORT_DELETE的 OID 集请求。 此 OID 请求从可扩展交换机中删除端口。
注意 扩展通过调用 ReferenceSwitchPort 递增可扩展交换机端口的引用计数器。 扩展通过调用 DereferenceSwitchPort 来递减引用计数器。
扩展必须遵循以下准则来处理OID_SWITCH_PORT_TEARDOWN的 OID 集请求:
扩展必须始终将此 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) |
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈