OID_NIC_SWITCH_CURRENT_CAPABILITIES

过度驱动程序向 OID_NIC_SWITCH_CURRENT_CAPABILITIES 的 OID (OID) 查询请求中发送对象标识符,以获取网络适配器中 NIC 交换机当前启用的硬件功能。

从 OID 查询请求成功返回后,该结构NDIS_OID_REQUEST InformationBuffer 成员包含指向该NDIS_NIC_SWITCH_CAPABILITIES指针。

注解

从 NDIS 6.20 开始,当调用微型端口 InitializeEx 函数时,微型端口驱动程序在网络适配器上提供当前启用的 NIC 交换机硬件功能。 驱动程序使用 NIC NDIS_NIC_SWITCH_CAPABILITIES功能初始化一个 NDIS_NIC_SWITCH_CAPABILITIES 结构,将 NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES 结构的 CurrentNicSwitchCapabilities 成员设置到指向 NDIS_NIC_SWITCH_CAPABILITIES 结构的指针。 然后,微型端口驱动程序调用 NdisMSetMiniportAttributes 函数,将 MiniportAttributes 参数设置到指向 NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES 的指针

注意 从 NDIS 6.30 开始,支持单根 I/O 虚拟化 (SR-IOV) 接口的微型端口驱动程序必须注册 NIC 交换机的已启用硬件功能。 驱动程序通过调用 NdisMSetMiniportAttributes 注册这些功能

过度协议和筛选器驱动程序不需要发出 OID 查询请求OID_NIC_SWITCH_CURRENT_CAPABILITIES。 NDIS 以下列方式为这些驱动程序提供网络适配器当前启用的 NIC 交换机硬件功能:

  • NDIS 报告基础网络适配器当前启用的 NIC 交换机硬件功能,以在绑定操作期间过度控制 NDIS_BIND_PARAMETERS 结构的 NicSwitchCapabilities 成员 中的 协议驱动程序。

  • NDIS 报告基础网络适配器当前启用的 NIC 交换机硬件功能,以在附加操作期间过度筛选 NDIS_FILTER_ATTACH_PARAMETERS 结构的 NicSwitchCapabilities 成员中的筛选器驱动程序。

返回状态代码

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

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

状态代码 说明

NDIS_STATUS_SUCCESS

请求已成功完成。 InformationBuffer指向NDIS_NIC_SWITCH_CAPABILITIES结构

NDIS_STATUS_NOT_SUPPORTED

微型端口驱动程序不支持单根 I/O 虚拟化 (SR-IOV) 接口,或者不支持使用该接口。

NDIS_STATUS_INVALID_LENGTH

信息缓冲区的长度小于 (NDIS_NIC_SWITCH_CAPABILITIES ) 。 微型端口驱动程序必须设置 DATA。QUERY_INFORMATION。BytesNeeded成员NDIS_OID_REQUEST到 所需的最小缓冲区大小。

NDIS_STATUS_FAILURE

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

要求

版本

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

标头

Ntddndis.h (包括 Ndis.h)

请参阅

NDIS_BIND_PARAMETERS

NDIS_FILTER_ATTACH_PARAMETERS

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES

NDIS_NIC_SWITCH_CAPABILITIES

NDIS_OID_REQUEST