OID_SWITCH_NIC_ARRAY

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

如果 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

由于其他原因,请求失败。

要求

版本

在 NDIS 6.30 和更高版本中受支持。

标头

Ntddndis (包含 Ndis .h)

请参阅


NDIS_OID_REQUEST

NDIS_SWITCH_NIC_ARRAY

NDIS_SWITCH_NIC_PARAMETERS

查询 Hyper-V 可扩展交换机配置