OID_NIC_SWITCH_VF_PARAMETERS

项目
06/15/2023

过分驱动程序或用户模式应用程序发出对象标识符 (OID) 方法请求OID_NIC_SWITCH_VF_PARAMETERS，以获取网络适配器上 PCI Express (PCIe) Virtual Function (VF) 的当前配置参数。只有通过 OID_NIC_SWITCH_ALLOCATE_VF 的 OID 方法请求分配了资源的 VF 才能通过 OID_NIC_SWITCH_VF_PARAMETERS 的 OID 方法请求进行查询。

NDIS 处理微型端口驱动程序OID_NIC_SWITCH_VF_PARAMETERS的 OID 方法请求。

发出 OID 方法请求时，NDIS_OID_REQUEST 结构的 InformationBuffer 成员包含指向 NDIS_NIC_SWITCH_VF_PARAMETERS 结构的指针。

注解

过度的驱动程序或用户模式应用程序通过将NDIS_NIC_SWITCH_VF_PARAMETERS结构的 VFId 成员设置为 VF 的标识符来指定要查询的 VF。过度覆盖的驱动程序或应用程序通过以下方法之一获取 VF 标识符：

通过发出 OID_NIC_SWITCH_ENUM_VFS 的 OID 方法请求。

如果此 OID 请求成功完成，则过度分配的驱动程序或用户模式应用程序将收到网络适配器上分配的所有 VF 的列表。列表中的每个元素都是 一个NDIS_NIC_SWITCH_VF_INFO 结构，其 VF 标识符由 VFId 成员指定。
通过发出 OID_NIC_SWITCH_ALLOCATE_VF 的 OID 方法请求。

如果此 OID 请求成功完成，则 overlying 驱动程序会在返回的 NDIS_NIC_SWITCH_VF_PARAMETERS 结构的 VFId 成员中接收新创建的 VF 的标识符。

注意只有过分的驱动程序才能以这种方式获取 VF 标识符。

从 OID 方法请求成功返回后，NDIS_OID_REQUEST 结构的 InformationBuffer 成员包含指向 NDIS_NIC_SWITCH_VF_PARAMETERS 结构的指针。此结构包含指定 VF 的配置参数。

返回状态代码

NDIS 处理微型端口驱动程序OID_NIC_SWITCH_VF_PARAMETERS的 OID 方法请求，并为 OID_NIC_SWITCH_VF_PARAMETERS 的 OID 方法请求返回以下状态代码。

状态代码	说明
NDIS_STATUS_SUCCESS	请求已成功完成。 InformationBuffer 成员指向NDIS_NIC_SWITCH_VF_PARAMETERS结构。
NDIS_STATUS_NOT_SUPPORTED	微型端口驱动程序不支持单根 I/O 虚拟化 (SR-IOV) 接口，或者未启用该接口。
NDIS_STATUS_INVALID_PARAMETER	NDIS_NIC_SWITCH_VF_PARAMETERS 结构的一个或多个成员具有无效值。
NDIS_STATUS_INVALID_LENGTH	信息缓冲区的长度小于大小 (NDIS_NIC_SWITCH_VF_PARAMETERS) 。 NDIS 设置数据。METHOD_INFORMATION。NDIS_OID_REQUEST结构中的 BytesNeeded 成员达到所需的最小缓冲区大小。
NDIS_STATUS_INVALID_LENGTH	信息缓冲区太短。 NDIS 设置数据。METHOD_INFORMATION。NDIS_OID_REQUEST结构中的 BytesNeeded 成员达到所需的最小缓冲区大小。
NDIS_STATUS_FAILURE	由于其他原因，请求失败。