OID_SWITCH_PORT_ARRAY
Hyper-V 可扩展交换机扩展会发出对象标识符 (OID) OID_SWITCH_PORT_ARRAY的查询请求来获取数组。 数组中的每个元素指定可扩展交换机端口的配置参数。
如果 OID 查询请求成功完成,则 NDIS_OID_REQUEST 结构的 InformationBuffer 成员包含指向缓冲区的指针。 此缓冲区包含以下数据:
定义数组中元素数的 NDIS_SWITCH_PORT_ARRAY 结构。
NDIS_SWITCH_PORT_PARAMETERS 结构的数组。 其中每个结构都包含有关可扩展交换机上的端口的信息。
注意如果未在可扩展交换机上创建任何端口,驱动程序会将 NDIS_SWITCH_PORT_ARRAY 结构的 NumElements 成员设置为零,并且不返回任何NDIS_SWITCH_PORT_PARAMETERS结构。
注解
仅当 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) |