OID_SWITCH_NIC_CONNECT
Hyper-V 可扩展交换机的协议边缘发出对象标识符 (OID) OID_SWITCH_NIC_CONNECT集请求,以通知基础可扩展交换机扩展,可扩展交换机端口和网络适配器之间的网络连接已完全建立。 协议边缘之前在发出 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,则当 NetEventSwitchActivateNET_PNP_EVENT 由扩展微型端口适配器发出时,扩展会发出 OID。
通过检查 OID_SWITCH_PORT_CREATE 和 OID_SWITCH_PORT_DELETE的各种 OID 集请求。
NDIS_SWITCH_NIC_PARAMETERS 结构的 Index 成员指定要为其发出连接通知的网络适配器的索引。 具有指定 Index 值的网络适配器连接到由 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_SWITCH_NIC_CONNECT OID 集请求。
有关可扩展交换机端口和网络适配器连接状态的详细信息,请参阅 Hyper-V 可扩展交换机端口和网络适配器状态。
返回状态代码
可扩展开关的基础微型端口边缘完成OID_SWITCH_NIC_CONNECT的 OID 集请求,并返回以下状态代码。
状态代码 | 说明 |
---|---|
NDIS_STATUS_SUCCESS |
OID 请求已成功完成。 |
要求
版本 |
在 NDIS 6.30 及更高版本中受支持。 |
标头 |
Ntddndis.h (包括 Ndis.h) |
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈