INF AddComponent 指令

  • 项目

AddComponent 指令在 INF DDInstall 中使用。扩展 INF 文件的组件部分。 它为当前设备下的软件组件创建虚拟子设备。 Windows 10版本 1703 及更高版本支持此指令。

[DDInstall.Components]

AddComponent=ComponentName,[flags],component-install-section

项

ComponentName

指定要创建的软件组件的名称。 INF 文件中的每个 AddComponent 指令必须具有唯一值。

flag

指定一个或多个 (ORed) 标志，这些标志当前未定义，但保留供将来使用。

component-install-section

引用 INF 编写器定义的部分，其中包含用于为此设备创建命名软件组件的信息。

注解

INF 编写器创建的每个节名称在 INF 文件中必须是唯一的，并且必须遵循定义节名称的一般规则。 有关这些规则的详细信息，请参阅 INF 文件的一般语法规则。

AddComponent 指令必须引用 INF 文件中其他位置的命名 component-install-section。 每个此类部分具有以下形式：

[component-install-section]

ComponentIDs=component-id[,component-id] …
[Description=description]

每个 component-install-section 必须至少有 ComponentID 条目 ，如下所示。 但是，其余条目是可选的。

请注意， ComponentID 是 HardwareID，这意味着它们是硬件开发人员定义的字符串。 为了确保这些 ID 的唯一性，在大多数情况下，我们建议遵循用于 PCI 设备的标识符架构。 供应商可能希望使用不同的架构，但这取决于方案。

例如，在单个设备上具有多个组件的供应商可能需要将该组件的硬件 ID 与父级相关联。 在这种情况下，他们可以通过将供应商定义的四个字符组件标识符追加到父级的硬件 ID 来创建 ComponentID 。

Component-Install节条目和值

ComponentIDs=id1[， id2] ...[， idN]

指定软件组件的组件标识符。 组件 ID 的工作方式与硬件 ID 相同，并且应遵循 类似的格式。 对于软件组件，系统会在 INF 提供的值 SWC\ 前面附加以创建硬件 ID。 例如， 的 ComponentIDs 值 VID0001&PID0001 会导致硬件 ID 为 SWC\VID0001&PID0001。

描述=描述

（可选）指定描述软件组件的字符串（通常用于本地化），表示为 INF Strings 节中定义的 %strkey% 标记。

如果说明字符串包含任何 %strkey% 标记，则每个标记最多可以表示 511 个字符。 任何字符串标记替换后的总字符串不应超过 1024 个字符。

另请参阅

使用组件 INF 文件。

DDInstall。组件

INF AddSoftware 指令