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 成员指定要为其发出断开连接通知的网络适配器的索引。 具有指定 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_REQUEST 的 OID 请求转发或发起到发出OID_SWITCH_NIC_DISCONNECT 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 来递增可扩展交换机引用计数器,则它不需要将其调用同步到发起或转发 OID 请求或 NDIS 状态指示及其用于管理 Hyper-V 可扩展交换机 OID 请求的代码。 扩展递增引用计数器后,可扩展交换机接口不会发出 OID_SWITCH_NIC_DELETE的 OID 集请求。

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

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

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

注意 扩展不得发出自己的 OID_SWITCH_NIC_DISCONNECT OID 集请求。

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

返回状态代码

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

状态代码 说明

NDIS_STATUS_SUCCESS

OID 请求已成功完成。

要求

版本

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

标头

Ntddndis.h (包括 Ndis.h)

另请参阅


NDIS_OID_REQUEST

NDIS_SWITCH_NIC_PARAMETERS

OID_SWITCH_NIC_DELETE

OID_SWITCH_PORT_ARRAY

ReferenceSwitchPort