Поделиться через

Директива 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 символа.

См. также:

Использование INF-файла компонента.

DDInstall. Компоненты

Директива INF AddSoftware