OID_NIC_SWITCH_PARAMETERS

项目
06/15/2023

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

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

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

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

从上一个 OID 方法请求 OID_NIC_SWITCH_ENUM_SWITCHES。
从 NDIS_BIND_PARAMETERS 结构的 NicSwitchArray 成员。 NDIS 在 ProtocolBindAdapterEx 函数的 BindParameters 参数中传递指向此结构的指针。
从 NDIS_FILTER_ATTACH_PARAMETERS 结构的 NicSwitchArray 成员。 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 处理 PF 微型端口驱动程序OID_NIC_SWITCH_PARAMETERS的 OID 方法请求。
超载驱动程序发出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。用于 OID 方法请求的 BytesNeeded 成员 () 或 DATA。SET_INFORMATION。OID 集请求的 BytesNeeded 成员 () NDIS_OID_REQUEST 结构中所需的最小缓冲区大小。
NDIS_STATUS_REINIT_REQUIRED	PF 微型端口驱动程序需要重新初始化网络适配器，以将更改应用到 NIC 交换机。
NDIS_STATUS_FAILURE	请求因其他原因而失败。