OID_NIC_SWITCH_ENUM_SWITCHES
过度分配的驱动程序或用户模式应用程序发出对象标识符 (OID) 查询请求OID_NIC_SWITCH_ENUM_SWITCHES以获取数组。 数组中的每个元素指定已在网络适配器上创建的 NIC 交换机的属性。
成功从此 OID 查询请求返回后，NDIS_OID_REQUEST 结构的 InformationBuffer 成员包含指向缓冲区的指针，其中包含以下内容：
定义数组中的元素数的 NDIS_NIC_SWITCH_INFO_ARRAY 结构。
NDIS_NIC_SWITCH_INFO结构的数组。 其中每个结构都包含有关在网络适配器上创建的单个 NIC 交换机的信息。
注意如果网络适配器没有 NIC 开关，驱动程序会将 NDIS_NIC_SWITCH_INFO_ARRAY 结构的 NumElements 成员设置为零，并且不会返回NDIS_NIC_SWITCH_INFO结构。
注解
过度覆盖驱动程序和用户模式应用程序发出OID_NIC_SWITCH_ENUM_SWITCHES的 OID 查询请求，以枚举在网络适配器上创建的 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) |