OID_NIC_SWITCH_ENUM_SWITCHES

过度的驱动程序或用户模式应用程序发出OID_NIC_SWITCH_ENUM_SWITCHES的对象标识符(OID)查询请求以获取数组。 数组中的每个元素指定已在网络适配器上创建的 NIC 交换机的属性。

从此 OID 查询请求成功返回后,NDIS_OID_REQUEST 结构的 InformationBuffer 成员包含指向包含以下项的缓冲区的指针:

言论

过度配置驱动程序和用户模式应用程序发出 OID 查询请求,OID_NIC_SWITCH_ENUM_SWITCHES枚举在网络适配器上创建的 NIC 交换机。

注意, 从 Windows Server 2012 开始,单根 I/O 虚拟化(SR-IOV)接口仅支持网络适配器上的默认 NIC 开关。 因此,返回 NDIS_NIC_SWITCH_INFO_ARRAY 结构必须为默认 NIC 开关指定单个 NDIS_NIC_SWITCH_INFO 元素,该元素由NDIS_DEFAULT_SWITCH_ID标识符引用。

返回状态代码

NDIS 处理微型端口驱动程序OID_NIC_SWITCH_ENUM_SWITCHES请求的 OID 查询请求。 驱动程序将不会发出此 OID 请求。

当 NDIS 处理OID_NIC_SWITCH_ENUM_SWITCHES请求时,它将返回以下状态代码之一。

状态代码 描述

NDIS_STATUS_SUCCESS

OID 请求已成功完成。

NDIS_STATUS_NOT_SUPPORTED

微型端口驱动程序要么不支持 SR-IOV 接口,要么未启用该接口。

NDIS_STATUS_INVALID_PARAMETER

NDIS_NIC_SWITCH_INFO_ARRAY 结构的一个或多个成员具有无效值。

NDIS_STATUS_INVALID_LENGTH

信息缓冲区太短。 NDIS 设置 数据。QUERY_INFORMATION。NDIS_OID_REQUEST 结构中的 BytesNeeded 成员达到所需的最小缓冲区大小。

NDIS_STATUS_FAILURE

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

要求

版本

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

页眉

Ntddndis.h (包括 Ndis.h)

另请参阅


NDIS_NIC_SWITCH_INFO

NDIS_NIC_SWITCH_INFO_ARRAY

NDIS_OID_REQUEST

OID_NIC_SWITCH_CREATE_SWITCH

OID_NIC_SWITCH_PARAMETERS