Diretiva INF AddComponent

Uma diretiva AddComponent é usada em uma DDInstall inf. Seção 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.

Remarks

Cada nome de seção criado pelo gravador INF 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 gerais de sintaxe 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 formulário:

[component-install-section]

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

Cada seção de instalação de componente 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.

Component-Install entradas e valores de seção

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 acrescenta os valores fornecidos SWC\ pelo INF para criar as IDs de hardware. Por exemplo, um valor ComponentIDs de VID0001&PID0001 resultados 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 de %strkey% definido em uma seção cadeias de caracteres INF.

Se uma cadeia de caracteres de descrição contiver qualquer token %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