OID_SWITCH_NIC_DELETE

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

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

注解

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

NDIS_SWITCH_NIC_PARAMETERS 结构的 Index 成员指定要为其发出删除通知的网络适配器的索引。 具有指定 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_SWITCH_NIC_DELETE的 OID 集请求。

  • 可扩展交换机外部网络适配器可以绑定到一个或多个基础物理适配器。 对于绑定到外部网络适配器的每个物理网络适配器,可扩展交换机的协议边缘会发出单独的 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