OID_SWITCH_NIC_DELETE

Hyper-V 可扩展交换机的协议边缘向可扩展交换机驱动程序堆栈发出OID_SWITCH_NIC_DELETE的对象标识符(OID)集请求。 此 OID 请求通知基础可扩展交换机扩展,说明删除可扩展交换机端口和网络适配器之间的连接。 可扩展交换机的协议边缘以前通知扩展,当它发出 OID 集 OID_SWITCH_NIC_DISCONNECT请求时,将删除此连接。

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

言论

NDIS_SWITCH_NIC_PARAMETERS 结构的 PortId 成员指定要为其发出删除通知的端口。 可扩展交换机扩展可以通过发出 OID_SWITCH_PORT_ARRAY的 OID 查询请求来获取此端口和其他端口的参数信息。

NDIS_SWITCH_NIC_PARAMETERS 结构的 Index 成员指定为其执行删除通知的网络适配器的索引。 具有指定 索引 值的网络适配器连接到由 PortId 成员指定的可扩展交换机端口。 有关这些索引值的详细信息,请参阅 网络适配器索引值

在可扩展交换机的协议边缘发出OID_SWITCH_NIC_DELETE请求之前,它保证已完成指定网络适配器连接的所有挂起的发送或接收数据包请求。 协议边缘还保证适配器连接的所有挂起的 OID 请求都已完成,适配器连接的可扩展交换机引用计数器具有零值。

注意 如果扩展通过调用 ReferenceSwitchNic递增了网络适配器的可扩展交换机引用计数器,则引用计数器为非零时不会发出OID_SWITCH_NIC_DELETE请求。 该扩展通过调用 DereferenceSwitchNic来递减可扩展交换机引用计数器。

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

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

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

  • 该扩展不得发出其自己的 OID 集OID_SWITCH_NIC_DELETE请求。

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

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

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

返回状态代码

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

状态代码 描述

NDIS_STATUS_SUCCESS

OID 请求已成功完成。

要求

版本

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

页眉

Ntddndis.h (包括 Ndis.h)

另请参阅


DereferenceSwitchNic

NDIS_OID_REQUEST

NDIS_SWITCH_NIC_PARAMETERS

OID_SWITCH_NIC_DISCONNECT

OID_SWITCH_PORT_ARRAY

ReferenceSwitchNic