Директива INF AddComponent
Директива AddComponent используется в inf DDInstall. Раздел Components в INF-файле расширения. Он создает виртуальное дочернее устройство для программного компонента текущего устройства. Эта директива поддерживается для Windows 10 версии 1703 и более поздних версий.
[DDInstall.Components]
AddComponent=ComponentName,[flags],component-install-section
Записи
ComponentName
Указывает имя создаваемого программного компонента. Каждая директива AddComponent в INF-файле должна иметь уникальное значение.
flags
Указывает один или несколько флагов (ORed), которые в настоящее время не определены, но зарезервированы для использования в будущем.
component-install-section
Ссылается на раздел, определенный inf-writer, который содержит сведения о создании именованного программного компонента для этого устройства.
Комментарии
Каждое имя раздела, созданного inf-writer, должно быть уникальным в ПРЕДЕЛАХ INF-файла и соответствовать общим правилам определения имен разделов. Дополнительные сведения об этих правилах см. в разделе Общие правила синтаксиса для ФАЙЛОВ INF.
Директива AddComponent должна ссылаться на именованный component-install-section в другом месте INF-файла . Каждый такой раздел имеет следующую форму:
[component-install-section]
ComponentIDs=component-id[,component-id] …
[Description=description]
Каждый раздел component-install-section должен иметь по крайней мере запись ComponentIDs , как показано здесь. Однако остальные записи являются необязательными.
Обратите внимание, что идентификаторы компонентов — это hardwareID, что означает, что они являются строками, определенными разработчиком оборудования. Чтобы обеспечить уникальность этих идентификаторов, в большинстве случаев рекомендуется следовать схеме идентификаторов, используемой для устройств PCI. Возможно, поставщику потребуется использовать другую схему, но это зависит от сценария.
Например, поставщику с несколькими компонентами на одном устройстве может потребоваться связать идентификаторы оборудования компонента с родительским. В этом случае они могут создать ComponentID , добавив четырехзначный идентификатор компонента, определяемый поставщиком, к идентификатору оборудования родительского объекта.
Записи и значения раздела Component-Install
Идентификаторы компонентов=id1[, id2] ... [, idN]
Указывает идентификаторы компонентов для программного компонента. Идентификаторы компонентов работают так же, как и идентификаторы оборудования, и должны следовать аналогичному форматированию. Для программного компонента система добавляет значения, предоставляемые SWC\ INF, с , чтобы создать идентификаторы оборудования. Например, значение VID0001&PID0001ComponentIDs приводит к идентификатору SWC\VID0001&PID0001оборудования .
Описание=Описание
При необходимости задает строку, описывающую программный компонент, обычно для локализации, выраженный в виде токена %strkey%, определенного в разделе Inf Strings.
Если строка описания содержит маркеры %strkey%, каждый маркер может представлять не более 511 символов. Общая строка после подстановки токена строки не должна превышать 1024 символа.