OID_SWITCH_NIC_CONNECT
Hyper-V 可扩展交换机的协议边缘发出OID_SWITCH_NIC_CONNECT的对象标识符(OID)集请求,以通知基础可扩展交换机扩展之间已完全建立可扩展交换机端口和网络适配器之间的网络连接。 协议边缘之前通知扩展在发出 OID 集请求 OID_SWITCH_NIC_CREATE时正在建立此连接。
NDIS_OID_REQUEST结构的 InformationBuffer 成员包含指向NDIS_SWITCH_NIC_PARAMETERS结构的指针。
注解
NDIS_SWITCH_NIC_PARAMETERS结构的 PortId 成员指定为其发出连接通知的可扩展交换机端口。 可扩展交换机扩展可以通过以下方式获取此端口和其他可扩展交换机端口的参数信息:
通过发出OID_SWITCH_PORT_ARRAY的 OID 查询请求。 仅当OID_SWITCH_PARAMETERS返回 isActive 设置为 TRUE 的 NDIS_SWITCH_PARAMETERS 结构时,该扩展才会在 FilterAttach 上发出此 OID。 如果 IsActive 为 FALSE,则扩展在扩展微型端口适配器发出 NetEventSwitchActivate NET_PNP_EVENT时发出 OID。
通过检查OID_SWITCH_PORT_CREATE和OID_SWITCH_PORT_DELETE的各种 OID 集请求。
NDIS_SWITCH_NIC_PARAMETERS结构的索引成员指定为其发出连接通知的网络适配器的索引。 具有指定索引值的网络适配器连接到 PortId 成员指定的可扩展交换机端口。 有关这些索引值的详细信息,请参阅 网络适配器索引值。
当它收到OID_SWITCH_NIC_CONNECT的 OID 集请求时,扩展必须遵循以下准则:
当OID_SWITCH_NIC_CONNECT请求完成NDIS_STATUS_SUCCESS时,网络连接和可扩展交换机端口将完全正常运行。 该扩展可以生成或转发到端口的网络连接的数据包流量。 该扩展还可以发出可扩展交换机 OID 或状态指示,这些指示使用端口作为源端口。 该扩展还可以调用 ReferenceSwitchPort 来递增端口的可扩展交换机引用计数器。
该扩展不得修改 与 OID 请求关联的NDIS_SWITCH_NIC_PARAMETERS 结构。
该扩展必须始终调用 NdisFOidRequest 才能将此 OID 请求转发到基础扩展。 扩展不能完成 OID 请求本身。
可扩展交换机外部网络适配器可以绑定到一个或多个基础物理适配器。 对于绑定到外部网络适配器的每个物理网络适配器,可扩展交换机的协议边缘都会发出单独的 OID 集请求OID_SWITCH_NIC_CONNECT。 每个 OID 集请求指定不同的网络适配器连接索引值。 有关这些值的详细信息,请参阅 网络适配器索引值。
该扩展必须维护绑定到外部网络适配器的每个基础物理适配器的连接状态。 有关物理网络适配器可以绑定到外部网络适配器的不同配置的详细信息,请参阅 物理网络适配器配置的类型。
请注意 ,该扩展不得发出其自己的 OID 集OID_SWITCH_NIC_CONNECT请求。
有关可扩展交换机端口和网络适配器连接的状态的详细信息,请参阅 Hyper-V 可扩展交换机端口和网络适配器状态。
返回状态代码
可扩展交换机的基础微型端口边缘完成OID_SWITCH_NIC_CONNECT的 OID 集请求,并返回以下状态代码。
状态代码 | 说明 |
---|---|
NDIS_STATUS_SUCCESS |
OID 请求已成功完成。 |
要求
版本 |
NDIS 6.30 及更高版本中受支持。 |
头文件 |
Ntddndis.h(包括 Ndis.h) |