Diretiva INF AddSoftware

Cada diretiva AddSoftware descreve a instalação de software autônomo. Essa diretiva deve ser usada em um arquivo INF da classe de instalação SoftwareComponent . Para obter mais detalhes sobre componentes de software, consulte Como usar um arquivo INF de componente. Essa diretiva tem suporte para Windows 10 versão 1703 e posterior.

Os tipos de instalação válidos dependem da plataforma de destino. Por exemplo, a Área de Trabalho dá suporte a instaladores MSI e à instalação de EXEs.

Quando um arquivo INF do componente de software especifica o AddSoftware, o sistema enfileira o software a ser instalado após a instalação do dispositivo. Não há garantia de quando ou se o software será instalado. Se o software referenciado não for instalado, o sistema tentará novamente quando o componente de software de referência for atualizado.

Uma diretiva AddSoftware é usada em uma DDInstall inf. Seção de software.

[DDInstall.Software]
AddSoftware=SoftwareName,[flags],software-install-section

Entradas

SoftwareName
Especifica o nome do software a ser instalado. Esse nome deve ser exclusivo em todo o sistema, independentemente do inf ou do nome da seção. O processamento de uma diretiva AddSoftware verifica a versão em relação ao software anterior instalado com o mesmo nome por uma diretiva AddSoftware de qualquer pacote de driver. Recomendamos a pré-criação do SoftwareName com o nome do fornecedor, por exemplo ContosoControlPanel.

sinalizadores
Especifica um ou mais sinalizadores (ORed).

0x00000000
A diretiva AddSoftware é processada apenas uma vez.

0x00000001
A diretiva AddSoftware é processada uma vez para cada dispositivo de componente que especifica AddSoftware com o mesmo SoftwareName exclusivo.

Por exemplo, considere uma configuração na qual três dispositivos são instalados usando o mesmo arquivo INF. O processo de instalação de software é executado apenas uma vez para sinalizadores 0x00000000 mas três vezes para sinalizadores 0x00000001.

software-install-section
Faz referência a uma seção definida pelo gravador INF que contém informações para instalar o software.

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 AddSoftware deve referenciar uma seção de instalação de software nomeada em outro lugar no arquivo INF. Cada seção desse tipo tem o seguinte formulário:

[software-install-section]

SoftwareType=type-code
[SoftwareBinary=path-to-binary]
[SoftwareArguments=argument[, argument] …]
[SoftwareVersion=w.x.y.z]
[SoftwareID=pfn://x.y.z]

Qualquer software instalado usando o AddSoftware deve ser instalado silenciosamente (ou silenciosamente). Em outras palavras, nenhuma interface do usuário pode ser mostrada ao usuário durante a instalação.

Qualquer software instalado usando o AddSoftwarenão será desinstalado se o dispositivo de componente de software virtual ou seus dispositivos pai estiverem desinstalados. Se o software não for um aplicativo UWP (ou seja, você está usando o AddSoftware com um SoftwareType de 1), verifique se os usuários podem desinstalá-lo facilmente sem deixar um rastreamento no registro. Para fazer isso:

• Se você estiver usando um instalador MSI, configure uma entrada Adicionar/Remover Programas no pacote Windows Instalador do aplicativo.

• Se você estiver usando um EXE personalizado que instale o estado global do registro/arquivo (em vez de complementar as configurações do dispositivo local), use a Chave do Registro de Desinstalação.

Entradas e valores de seção de instalação de software

SoftwareType={type-code}
SoftwareType especifica o tipo de instalação de software e é uma entrada necessária.

Um valor de 1 indica que o software associado é um binário MSI ou EXE. Quando esse valor é definido, a entrada SoftwareBinary também é necessária. Não há suporte para um valor de 1 no Windows 10 S.

Se SoftwareType for definido como 1, SoftwareBinary e SoftwareVersion também serão necessários, mas SoftwareArguments e sinalizadores (na diretiva AddSoftware ) serão opcionais.

A partir Windows 10 versão 1709, um valor 2 indica que o software associado é um link Microsoft Store. Use um valor de 1 apenas para software específico do dispositivo que não tenha nenhuma interface gráfica do usuário. Se você tiver um aplicativo específico do dispositivo com elementos gráficos, ele deverá vir do Microsoft Store e o driver deverá referenciá-lo usando um valor SoftwareType de 2.

Se SoftwareType for definido como 2, SoftwareID será necessário e sinalizadores (na diretiva AddSoftware ) serão opcionais. Se SoftwareType for definido como 2, SoftwareBinary e SoftwareVersion não serão usados.

Não use o AddSoftware para distribuir software não relacionado a um dispositivo. Por exemplo, um programa utilitário de COMPUTADOR específico do OEM não deve ser instalado com o AddSoftware. Em vez disso, use uma das seguintes opções para pré-instalar um aplicativo em uma imagem OEM de Windows 10:

• Para pré-instalar um aplicativo Win32, inicialize para o modo de auditoria e instale o aplicativo. Para obter detalhes, consulte Visão geral do modo de auditoria.

• Para pré-instalar um aplicativo Microsoft Store (UWP), consulte aplicativos pré-instalados para dispositivos da área de trabalho

Para obter informações sobre como emparelhar um driver com um aplicativo Plataforma Universal do Windows (UWP), consulte Emparelhamento de um driver com um aplicativo Plataforma Universal do Windows (UWP) e HSA (aplicativo de suporte de hardware): etapas para desenvolvedores de driver.

SoftwareBinary={filename}
Especifica o caminho para o executável. O sistema gera linhas de comando como as seguintes:

MSI: msiexec /i "<SoftwareBinary>" ALLUSERS=1 /quiet /qn /promptrestart [<SoftwareArguments>]

EXE: <SoftwareBinary> [<SoftwareArguments>]

Se você usar essa entrada, deverá adicionar o executável ao DriverStore especificando a diretiva INF CopyFiles com um valor DestinationDirs de 13.

SoftwareArguments={argument1[, argument2[, ... argumentN]]}
Especifica argumentos específicos de extensão a serem acrescentados à linha de comando. Você pode especificar argumentos de linha de comando que o sistema simplesmente passa para a linha de comando gerada. Você também pode especificar cadeias de caracteres especiais chamadas variáveis de contexto de runtime. Quando você especifica uma variável de contexto de runtime, o sistema a converte em um valor específico do dispositivo antes de anexá-la à linha de comando gerada. Você pode misturar e combinar argumentos de cadeia de caracteres literais com variáveis de contexto de runtime. As variáveis de contexto de runtime com suporte são:

<<DeviceInstanceID>>

O sistema substitui a cadeia de caracteres acima pela ID da instância do dispositivo do componente de software.

Por exemplo:

    [DDInstall.Software]
    AddSoftware=ContosoControlPanel,,Contoso_ControlPanel_Software

    [Contoso_ControlPanel_Software]
    SoftwareType=1
    SoftwareBinary=ContosoControlPanel.exe
    SoftwareArguments=<<DeviceInstanceID>>
    SoftwareVersion=1.0.0.0

O exemplo acima resulta em uma linha de comando como esta:

<DriverStorePath>\ContosoControlPanel.exe PCI\VEN_0000&DEV_0001&SUBSYS_00000000&REV_00\0123

Se SoftwareArguments contiver vários argumentos:

    SoftwareArguments=arg1,<<DeviceInstanceID>>,arg2

Os resultados acima resultam em:

<DriverStorePath>\ContosoControlPanel.exe arg1 PCI\VEN_0000&DEV_0001&SUBSYS_00000000&REV_00\0123 arg2

SoftwareVersion={w.x.y.z}
Especifica a versão do software. Cada valor não deve exceder 65535. Quando o sistema encontra um SoftwareName duplicado, ele verifica o SoftwareVersion em relação ao SoftwareVersion anterior. Se for maior, Windows executará o software.

SoftwareID={x.y.z}
Especifica um identificador de Microsoft Store e um tipo de identificador. Atualmente, há suporte apenas para PFN (Nome da Família de Pacotes). Use um PFN para fazer referência a um aplicativo Plataforma Universal do Windows (UWP) usando o formuláriopfn://<x.y.z>.

Consulte Também

Usando um arquivo INF de componente

Seção INF DDInstall.Software

Diretiva AddComponent do INF

Emparelhar um driver com um aplicativo da UWP (Plataforma Universal do Windows).

Aplicativo de suporte de hardware (HSA): etapas para desenvolvedores de drivers