SR-IOV 的标准化 INF 关键字

本主题介绍单根 I/O 虚拟化 (SR-IOV) 接口的标准化 INF 关键字。这些关键字适用于 PCI Express (PCIe) 物理功能 (SR-IOV 网络适配器的 PF) 的微型端口驱动程序的 INF 文件。

以下部分介绍了 SR-IOV INF 关键字：

用于启用或禁用 SR-IOV 支持的标准化 INF 关键字

标准化 INF 关键字定义为启用或禁用对网络适配器的 SR-IOV 功能的支持。

*SRIOV
一个值，该值描述设备是启用或禁用 SR-IOV 功能。

安装驱动程序后，管理员可以在网络适配器的“高级”属性页中更新 *SRIOV 关键字 (keyword) 值。有关高级属性的详细信息，请参阅指定高级属性页的配置参数。

注意在适配器的 “高级 ”属性页中进行更改后，微型端口驱动程序会自动重启。

*SriovPreferred
一个值，该值定义是应启用 SR-IOV 功能而不是虚拟机队列 (VMQ) ，还是接收端缩放 (RSS) 功能。

这是一个隐藏关键字 (keyword) 值，不能在 INF 文件中指定，并且不会显示在网络适配器的高级属性页中。

有关如何解释 SR-IOV、VMQ 和 RSS 关键字的详细信息，请参阅处理 SR-IOV、VMQ 和 RSS 标准化 INF 关键字。

SR-IOV 标准化 INF 关键字是枚举关键字，如下表所述。下表中的列描述了枚举关键字 (keyword) 的以下属性：

SubkeyName
必须在 INF 文件中指定的关键字 (keyword) 的名称。此名称也会显示在网络适配器的 NDI\params\ 键下的注册表中。

ParamDesc
与 SubkeyName 关联的显示文本关键字 (keyword) 。

注意独立硬件供应商 (IHV) 可以为 SubkeyName 定义任何描述性文本。

值
与列表中每个 SubkeyName 关联的枚举整数值关键字 (keyword) 。

EnumDesc
与菜单中显示的每个值关联的显示文本。

SubkeyName	ParamDesc	值	EnumDesc
*SRIOV	SR-IOV	0	已禁用
		1 (默认)	Enabled
*SriovPreferred	此子项的 ParamDesc 和 EnumDesc 条目不能用于 INF 文件或用户界面。	0（默认值）	基于 VmqOrRssPreferrence 关键字 (keyword) 报告 RSS 或 VMQ 功能。不报告 SR-IOV 功能。有关 VmqOrRssPreferrence 关键字 (keyword) 的详细信息，请参阅 VMQ 的标准化 INF 关键字。
		1	报告 SR-IOV 功能。

有关标准化 INF 关键字的详细信息，请参阅网络设备的标准化 INF 关键字。

从Windows Server 2012开始，SR-IOV 接口仅支持网络适配器上的一个 NIC 交换机。此开关称为 默认 NIC 开关，由NDIS_DEFAULT_SWITCH_ID标识符引用。

PF 微型端口驱动程序的 INF 文件必须指定 SR-IOV 网络适配器上默认 NIC 交换机的配置。这允许网络安装程序将默认交换机配置信息从 INF 复制到默认交换机 (NDI\params\NicSwitches\0) 的子项下的微型端口注册表配置。

这些关键字不显示在网络适配器的 “高级 ”属性页中，用户无法配置。这些关键字是使用 INF 文件的 DDInstall 节中的 AddReg 指令指定的。每个关键字 (keyword) 由单独的 AddReg 指令指定。

下表描述了 SR-IOV 网络适配器的默认 NIC 交换机配置的 INF 关键字。此表中的列描述了这些关键字的以下属性：

SubkeyName
必须在 INF 文件中指定的关键字 (keyword) 的名称。此名称还会显示在网络适配器的 NDI\params\NicSwitches\0 密钥下的注册表中。

数据值
与 SubkeyName 关键字 (keyword) 关联的值。

数据类型
数据值的类型。

SubkeyName	数据值	数据类型	说明
*标志	0	REG_DWORD	必须为关键字 (keyword) 分配此值。
*SwitchType	1	REG_DWORD	必须为关键字 (keyword) 分配此值。
*SwitchId	0	REG_DWORD	必须为关键字 (keyword) 分配此值。
*SwitchName	“默认开关”	REG_SZ	必须为关键字 (keyword) 分配此值。
*NumVF	(0-n) ，	REG_DWORD	n 是 SR-IOV 网络适配器支持的 PCIe 虚拟函数 (VF) 的最大数目。注意此注册表项定义网络适配器支持的最大 VF 数。当微型端口驱动程序调用 NdisMSetMiniportAttributes 时，它可以播发小于此值，具体取决于网络适配器上的可用硬件资源。有关详细信息，请参阅确定 NIC 交换机功能。

下面是 SR-IOV 网络适配器的默认 NIC 交换机配置的 AddReg 指令示例：

HKR, NicSwitches\0, *SwitchId,   0x00010001, 0
HKR, NicSwitches\0, *SwitchName, 0x00000000, “Default Switch”

有关 AddReg 指令的语法的详细信息，请参阅 INF AddReg 指令。

有关默认 NIC 开关的详细信息，请参阅 NIC 开关。