OID_SWITCH_PORT_ARRAY

Hyper-V 可扩展交换机扩展会发出对象标识符 (OID) OID_SWITCH_PORT_ARRAY的查询请求来获取数组。 数组中的每个元素指定可扩展交换机端口的配置参数。

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

注解

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

当扩展处理返回 的 NDIS_SWITCH_PORT_PARAMETERS 结构时,它不得假定 NDIS_SWITCH_PORT_PARAMETERS 结构的各种字符串成员(如 PortName)以 null 结尾。 这些字符串成员的数据类型是由 IF_COUNTED_STRING 结构定义的类型。 驱动程序必须从此结构的 Length 成员的值中确定字符串长度。

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

返回状态代码

可扩展开关的基础微型端口边缘完成 OID_SWITCH_PORT_ARRAY 的 OID 查询请求,并返回以下状态代码之一。

状态代码 说明

NDIS_STATUS_SUCCESS

OID 请求已成功完成。

NDIS_STATUS_INVALID_LENGTH

信息缓冲区的长度太小,无法返回 NDIS_SWITCH_PORT_ARRAY 及其 NDIS_SWITCH_PORT_PARAMETERS 元素数组。 可扩展交换机的基础微型端口边缘设置 DATA。QUERY_INFORMATION。NDIS_OID_REQUEST结构中的 BytesNeeded 成员达到所需的最小缓冲区大小。

NDIS_STATUS_FAILURE

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

要求

版本

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

标头

Ntddndis.h (包括 Ndis.h)

另请参阅


NDIS_OID_REQUEST

NDIS_SWITCH_PORT_ARRAY

NDIS_SWITCH_PORT_PARAMETERS

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