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 关键字。
用于配置默认 NIC 交换机的标准化 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 开关。