OID_NIC_SWITCH_PARAMETERS

2025-03-13

过度的驱动程序发出OID_NIC_SWITCH_PARAMETERS的对象标识符（OID）方法请求，以获取网络适配器上指定 NIC 交换机的当前配置参数。 NDIS 处理微型端口驱动程序的这些 OID 方法请求。

过度分配驱动程序发出OID_NIC_SWITCH_PARAMETERS的 OID 集请求，以在网络适配器上设置指定 NIC 交换机的配置参数。这些 OID 集请求将颁发给网络适配器的 PCI Express（PCIe）物理功能（PF）的微型端口驱动程序。支持单个根 I/O 虚拟化（SR-IOV）接口的 PF 微型端口驱动程序需要这些 OID 集请求。

NDIS_OID_REQUEST 结构的 InformationBuffer 成员包含指向 NDIS_NIC_SWITCH_PARAMETERS 结构的指针。

过度分配驱动程序通过将 NDIS_NIC_SWITCH_PARAMETERS 结构的 SwitchId 成员设置为开关标识符来指定 OID 方法的 NIC 开关或设置请求。过度的驱动程序通过以下方法之一获取交换机标识符：

从以前的 OID_NIC_SWITCH_ENUM_SWITCHESOID 方法请求。
从 NicSwitchArrayNDIS_BIND_PARAMETERS 结构的成员。 NDIS 在 ProtocolBindAdapterEx 函数的 BindParameters 参数中传递指向此结构的指针。
从 NicSwitchArrayNDIS_FILTER_ATTACH_PARAMETERS 结构的成员。 NDIS 在 FilterAttach 函数的 AttachParameters 参数中传递指向此结构的指针。

注释从 Windows Server 2012 开始，Windows 仅支持网络适配器上的默认 NIC 开关。 NDIS_NIC_SWITCH_PARAMETERS 结构的 SwitchId 成员必须设置为NDIS_DEFAULT_SWITCH_ID。

言论

过度的驱动程序通过以下方式OID_NIC_SWITCH_PARAMETERS请求：

过度的驱动程序发出OID_NIC_SWITCH_PARAMETERS的 OID 方法请求以获取指定 NIC 交换机的当前参数。有关详细信息，请参阅查询 NIC 交换机的参数。

注释 NDIS 处理 OID 方法请求的 PF 微型端口驱动程序的OID_NIC_SWITCH_PARAMETERS。
过度分配的驱动程序发出OID_NIC_SWITCH_PARAMETERS的 OID 集请求，以更改指定 NIC 交换机的当前参数。有关详细信息，请参阅设置 NIC 交换机的参数。

注意 PF 微型端口驱动程序处理OID_NIC_SWITCH_PARAMETERS的 OID 集请求。

返回状态代码

NDIS 或 PF 微型端口驱动程序返回以下OID_NIC_SWITCH_PARAMETERS设置或方法 OID 请求的状态代码。

状态代码	描述
NDIS_STATUS_SUCCESS	请求成功完成。 InformationBuffer 指向 NDIS_NIC_SWITCH_CAPABILITIES 结构。
NDIS_STATUS_NOT_SUPPORTED	PF 微型端口驱动程序要么不支持单个根 I/O 虚拟化（SR-IOV）接口，要么未启用该接口。
NDIS_STATUS_INVALID_PARAMETER	NDIS_NIC_SWITCH_PARAMETERS 结构的一个或多个成员具有无效值。
NDIS_STATUS_INVALID_LENGTH	信息缓冲区太短。 NDIS 或 PF 微型端口驱动程序设置数据。METHOD_INFORMATION。BytesNeeded 成员（对于 OID 方法请求）或 DATA。SET_INFORMATION。NDIS_OID_REQUEST 结构中的 BytesNeeded 成员（对于 OID 集请求）到所需的最小缓冲区大小。
NDIS_STATUS_REINIT_REQUIRED	PF 微型端口驱动程序需要重新初始化网络适配器才能将更改应用到 NIC 交换机。
NDIS_STATUS_FAILURE	由于其他原因，请求失败。