OID_SWITCH_NIC_ARRAY

2025-03-13

Hyper-V 可扩展交换机扩展发出OID_SWITCH_NIC_ARRAY的对象标识符（OID）查询请求以获取数组。数组中的每个元素指定与可扩展交换机端口关联的虚拟网络适配器的配置参数。

如果 OID 查询请求成功完成，则 NDIS_OID_REQUEST 结构的 InformationBuffer 成员包含指向缓冲区的指针。此缓冲区包含以下数据：

定义数组中元素数的 NDIS_SWITCH_NIC_ARRAY 结构。此结构还指定数组中第一个元素的偏移量。
NDIS_SWITCH_NIC_PARAMETERS 结构的数组。其中每个结构都包含有关连接到可扩展交换机端口的网络适配器的信息。

注意如果没有网络适配器连接到可扩展交换机端口，可扩展交换机的基础微型端口边缘会将 NDIS_SWITCH_NIC_ARRAY 结构成员 NumElements 设置为零。在这种情况下，不会返回 NDIS_SWITCH_NIC_PARAMETERS 结构。

言论

仅当 Hyper-V 可扩展交换机已完成激活时，才能发出OID_SWITCH_NIC_ARRAY OID。有关详细信息，请参阅查询 Hyper-V 可扩展交换机配置。

当扩展处理返回的 NDIS_SWITCH_NIC_PARAMETERS 结构时，它不得假定 NDIS_SWITCH_PORT_PARAMETERS 结构的各个字符串成员（如 NicFriendlyName）以 NULL 结尾。这些字符串成员的数据类型由 IF_COUNTED_STRING 结构定义。驱动程序必须从此结构的 Length 成员的值确定字符串长度。

注意如果字符串以 null 结尾，则长度成员不得包含终止 null 字符。

返回状态代码

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

状态代码	描述
NDIS_STATUS_SUCCESS	OID 请求已成功完成。
NDIS_STATUS_INVALID_LENGTH	信息缓冲区的长度太小，无法返回 NDIS_SWITCH_NIC_ARRAY 及其 NDIS_SWITCH_NIC_PARAMETERS 元素数组。可扩展交换机的基础微型端口边缘设置数据。QUERY_INFORMATION。NDIS_OID_REQUEST 结构中的 BytesNeeded 成员达到所需的最小缓冲区大小。
NDIS_STATUS_FAILURE	由于其他原因，请求失败。