Partilhar via


Diretiva AddComponent do INF

Uma diretiva AddComponent é usada em um INF DDInstall. Seção de componentes de um arquivo INF de extensão. Ele cria um dispositivo filho virtual para o componente de software no dispositivo atual. Essa diretiva tem suporte para Windows 10 versão 1703 e posterior.

[DDInstall.Components]

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

Entradas

ComponentName

Especifica o nome do componente de software a ser criado. Cada diretiva AddComponent em um arquivo INF deve ter um valor exclusivo.

sinalizadores

Especifica um ou mais sinalizadores (ORed), atualmente indefinidos, mas reservados para uso futuro.

component-install-section

Faz referência a uma seção definida pelo gravador INF que contém informações para criar o componente de software nomeado para este dispositivo.

Comentários

Cada nome de seção criado pelo inf-writer deve ser exclusivo dentro do arquivo INF e deve seguir as regras gerais para definir nomes de seção. Para obter mais informações sobre essas regras, consulte Regras de sintaxe geral para arquivos INF.

Uma diretiva AddComponent deve referenciar uma seção de instalação de componente nomeada em outro lugar no arquivo INF. Cada seção desse tipo tem o seguinte formato:

[component-install-section]

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

Cada component-install-section deve ter pelo menos a entrada ComponentIDs , conforme mostrado aqui. No entanto, as entradas restantes são opcionais.

Observe que ComponentIDs são HardwareIDs, o que significa que são cadeias de caracteres definidas pelo desenvolvedor de hardware. Para garantir a exclusividade dessas IDs, na maioria dos casos, recomendamos seguir o esquema de identificador usado para dispositivos PCI. É possível que um fornecedor queira usar um esquema diferente, mas isso depende do cenário.

Por exemplo, um fornecedor com vários componentes em um único dispositivo pode querer associar as IDs de hardware do componente ao pai. Nesse caso, eles podem criar uma ComponentID acrescentando um identificador de componente definido pelo fornecedor de quatro caracteres à ID de hardware do pai.

Entradas e valores da seção Component-Install

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

Especifica os identificadores de componente para um componente de software. As IDs de componente funcionam da mesma maneira que as IDs de hardware e devem seguir a formatação semelhante. Para um componente de software, o sistema anexa os valores fornecidos por INF com SWC\ para criar as IDs de hardware. Por exemplo, um valor ComponentIDs de VID0001&PID0001 resulta em uma ID de hardware de SWC\VID0001&PID0001.

Descrição=Descrição

Opcionalmente, especifica uma cadeia de caracteres que descreve o componente de software, normalmente para localização, expresso como um token %strkey% definido em uma seção cadeias de caracteres INF.

Se uma cadeia de caracteres de descrição contiver tokens %strkey%, cada token poderá representar um máximo de 511 caracteres. A cadeia de caracteres total, após quaisquer substituições de token de cadeia de caracteres, não deve exceder 1024 caracteres.

Consulte Também

Usando um arquivo INF de componente.

DDInstall. Componentes

Diretiva InF AddSoftware