OID_SWITCH_NIC_DISCONNECT

Hyper-v 可扩展交换机的协议边缘 (OID 发出对象标识符) 设置 OID_SWITCH_NIC_DISCONNECT 请求,通知底层可扩展交换机端口与网络适配器之间的连接已被破坏。 完全断开连接后,可扩展交换机的协议边缘将发出 OID_SWITCH_NIC_DELETE的 OID 设置请求。

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

注解

NDIS_SWITCH_NIC_PARAMETERS结构的index成员指定正在为其发出断开连接通知的网络适配器的索引。 具有指定 索引 值的网络适配器连接到由 PortId 成员指定的可扩展交换机端口。 有关这些索引值的详细信息,请参阅 网络适配器索引值

此扩展在处理 OID_SWITCH_NIC_DISCONNECT 的 OID 集请求时必须遵循以下准则:

  • 扩展不得修改与 OID 请求关联的 NDIS_SWITCH_NIC_PARAMETERS 结构。

  • OID_SWITCH_NIC_DISCONNECT 请求仅通知扩展:在指定的网络适配器和可扩展交换机端口之间,可扩展交换机连接将被断开。 扩展处理此 OID 请求后,不能执行以下操作:

    • 为发出 OID_SWITCH_NIC_DISCONNECT OID 请求的可扩展交换机端口上的网络适配器连接生成任何数据包流量。

    • 调用 ReferenceSwitchNic ,以在可扩展交换机端口上为指定网络适配器连接递增可扩展交换机引用计数器。

    • 向发出了 OID_SWITCH_NIC_DISCONNECT OID 请求的基础网络适配器转发或发起 OID_SWITCH_NIC_REQUEST 的 oid 请求。

      注意 如果名为 ReferenceSwitchNic 的扩展在发出 OID_SWITCH_NIC_DISCONNECT 之前递增可扩展交换机引用计数器,则扩展仍可转发或发起 OID 请求。

    • 从为其发出 OID_SWITCH_NIC_DISCONNECT OID 请求的基础网络适配器转发或发起 NDIS_STATUS_SWITCH_NIC_STATUS 的 NDIS 状态指示。

      注意 如果名为 ReferenceSwitchNic 的扩展在发出 OID_SWITCH_NIC_DISCONNECT 之前递增可扩展交换机引用计数器,则扩展仍可转发或产生 NDIS 状态指示。

      注意 如果扩展之前调用 ReferenceSwitchNic 来递增可扩展交换机引用计数器,则不需要将其调用与管理 hyper-v 可扩展交换机 OID 请求的代码进行同步或转发 OID 请求或 NDIS 状态指示。 扩展增量引用计数器之后,可扩展交换机接口不会发出 OID_SWITCH_NIC_DELETE的 OID 集请求。

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

  • 可扩展交换机外部网络适配器可以绑定到一个或多个基础物理适配器。 对于绑定到外部网络适配器的每个物理网络适配器,可扩展交换机的协议边缘发出 OID_SWITCH_NIC_DISCONNECT 的单独 OID 集请求。 每个 OID 集请求指定一个不同的网络适配器连接索引值。 有关这些索引值的详细信息,请参阅 网络适配器索引值

    扩展必须维护每个基础物理适配器的连接状态。 有关可以将物理网络适配器绑定到外部网络适配器的不同配置的详细信息,请参阅 物理网络适配器配置的类型

注意 扩展不能发出自己的 OID_SWITCH_NIC_DISCONNECT 的 OID 设置请求。

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

返回状态代码

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

状态代码 说明

NDIS_STATUS_SUCCESS

OID 请求已成功完成。

要求

版本

在 NDIS 6.30 和更高版本中受支持。

标头

Ntddndis (包含 Ndis .h)

请参阅


NDIS_OID_REQUEST

NDIS_SWITCH_NIC_PARAMETERS

OID_SWITCH_NIC_DELETE

OID_SWITCH_PORT_ARRAY

ReferenceSwitchPort