Direttiva INF AddSoftware

Ogni direttiva AddSoftware descrive l'installazione di software autonomo. Questa direttiva deve essere usata in un file INF della classe di installazione SoftwareComponent . Per altre informazioni sui componenti software, vedere Uso di un file INF del componente. Questa direttiva è supportata per Windows 10 versione 1703 e successive.

I tipi di installazione validi dipendono dalla piattaforma di destinazione. Desktop, ad esempio, supporta i programmi di installazione MSI e configura EXEs.

Nota

Il tipo 2 è supportato nei driver universali, il tipo 1 è solo desktop.

Quando un file INF del componente software specifica AddSoftware, il software della coda di sistema da installare dopo l'installazione del dispositivo. Non vi è alcuna garanzia quando o se il software verrà installato. Se l'installazione del software a cui si fa riferimento non riesce, il sistema tenta di nuovo quando viene aggiornato il componente software di riferimento.

Una direttiva AddSoftware viene usata all'interno di un inF DDInstall. Sezione Software .

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

Voci

SoftwareName
Specifica il nome del software da installare. Questo nome deve essere univoco a livello di sistema, indipendentemente dal nome INF o della sezione. L'elaborazione di una direttiva AddSoftware controlla la versione rispetto al software precedente installato con lo stesso nome da una direttiva AddSoftware da qualsiasi pacchetto driver. È consigliabile anteporre a SoftwareName il nome del fornitore, ad esempio ContosoControlPanel.

flags
Specifica uno o più flag (ORed).

0x00000000
La direttiva AddSoftware viene elaborata una sola volta.

0x00000001
La direttiva AddSoftware viene elaborata una sola volta per ogni dispositivo componente che specifica AddSoftware con lo stesso SoftwareName univoco.

Si consideri, ad esempio, una configurazione in cui vengono installati tre dispositivi usando lo stesso file INF. Il processo di installazione software viene eseguito una sola volta per i flag 0x00000000 ma tre volte per i flag 0x00000001.

software-install-section
Fa riferimento a una sezione definita dal writer INF che contiene informazioni per l'installazione del software.

Remarks

Ogni nome di sezione creato da INF-writer deve essere univoco all'interno del file INF e deve seguire le regole generali per la definizione dei nomi di sezione. Per altre informazioni su queste regole, vedere Regole di sintassi generali per i file INF.

Una direttiva AddSoftware deve fare riferimento a una sezione software-install-section denominata altrove nel file INF. Ogni sezione di questo tipo ha il formato seguente:

[software-install-section]

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

Nota

Per informazioni sui vincoli relativi alle voci e ai valori della sezione, vedere SoftwareType .

Qualsiasi software installato con AddSoftware deve essere installato in modalità invisibile all'utente (o in modalità non interattiva). In altre parole, nessuna interfaccia utente può essere visualizzata all'utente durante l'installazione.

Qualsiasi software installato con AddSoftwarenon verrà disinstallato se il dispositivo del componente software virtuale o i relativi dispositivi padre vengono disinstallati. Se il software non è un'app UWP (ad esempio, stai usando AddSoftware con un SoftwareType 1), assicurati che gli utenti possano disinstallarlo facilmente senza lasciare una traccia nel Registro di sistema. A questo scopo:

  • Se si usa un programma di installazione MSI, configurare una voce Installazione applicazioni nel pacchetto del programma di installazione di Windows dell'applicazione.

  • Se si usa un file EXE personalizzato che installa lo stato globale del Registro di sistema o del file (invece di integrare le impostazioni del dispositivo locale), usare la chiave del Registro di sistema disinstalla.

Voci e valori della sezione Installazione software

SoftwareType={type-code}
SoftwareType specifica il tipo di installazione software ed è una voce obbligatoria.

Il valore 1 indica che il software associato è un file binario MSI o EXE. Quando questo valore è impostato, è necessaria anche la voce SoftwareBinary . Il valore 1 non è supportato in Windows 10 S.

Se SoftwareType è impostato su 1, sono necessari anche SoftwareBinary e SoftwareVersion, ma SoftwareArguments e flag (nella direttiva AddSoftware) sono facoltativi.

A partire da Windows 10 versione 1709, il valore 2 indica che il software associato è un collegamento Microsoft Store. Usare il valore 1 solo per il software specifico del dispositivo senza interfaccia utente grafica. Se si dispone di un'app specifica del dispositivo con elementi grafici, deve provenire dalla Microsoft Store e il driver deve farvi riferimento usando un valore SoftwareType pari a 2.

Se SoftwareType è impostato su 2, SoftwareID è obbligatorio e i flag (nella direttiva AddSoftware) sono facoltativi. Se SoftwareType è impostato su 2, Non vengono usati SoftwareBinary e SoftwareVersion .

Nota

Quando si usa SoftwareType 2 della direttiva AddSoftware, non è necessario utilizzare un COMPONENTE INF. La direttiva può essere usata correttamente in qualsiasi INF. Una direttiva AddSoftware di tipo 1, tuttavia, deve essere usata da un COMPONENTE INF.

Non usare AddSoftware per distribuire software non correlato a un dispositivo. Ad esempio, un programma di utilità PC specifico dell'OEM non deve essere installato con AddSoftware. Usare invece una delle opzioni seguenti per preinstallare un'app in un'immagine OEM di Windows 10:

Per informazioni sull'associazione di un driver a un'app Piattaforma UWP (Universal Windows Platform), vedi Associazione di un driver a un'app Piattaforma UWP (Universal Windows Platform) e app di supporto hardware (HSA): Passaggi per sviluppatori di driver.

SoftwareBinary={filename}
Specifica il percorso del file eseguibile. Il sistema genera righe di comando simili alle seguenti:

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

EXE: <SoftwareBinary> [<SoftwareArguments>]

Se si usa questa voce, è necessario aggiungere l'eseguibile a DriverStore specificando la direttiva COPYFiles INF con un valore DestinationDirs pari a 13.

Nota

Per informazioni sui vincoli relativi a voci e valori softwareBinary, vedere SoftwareType.

SoftwareArguments={argument1[, argument2[, ... argumentN]]}
Specifica gli argomenti specifici dell'estensione da aggiungere alla riga di comando. È possibile specificare gli argomenti della riga di comando che il sistema passa semplicemente nella riga di comando generata. È anche possibile specificare stringhe speciali denominate variabili di contesto di runtime. Quando si specifica una variabile di contesto di runtime, il sistema lo converte in un valore specifico del dispositivo prima di accodarlo alla riga di comando generata. È possibile combinare e associare argomenti stringa letterali con variabili di contesto di runtime. Le variabili di contesto di runtime supportate sono:

<<DeviceInstanceID>>

Il sistema sostituisce la stringa precedente con l'ID istanza del dispositivo del componente software.

Ad esempio:

    [DDInstall.Software]
    AddSoftware=ContosoControlPanel,,Contoso_ControlPanel_Software

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

L'esempio precedente genera una riga di comando simile alla seguente:

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

Se SoftwareArguments contiene più argomenti:

    SoftwareArguments=arg1,<<DeviceInstanceID>>,arg2

I risultati precedenti sono i seguenti:

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

Nota

Per informazioni sui vincoli relativi alle voci e ai valori di SoftwareArguments, vedere SoftwareType.

SoftwareVersion={w.x.y.z}
Specifica la versione del software. Ogni valore non deve superare 65535. Quando il sistema rileva un softwareName duplicato, controlla SoftwareVersion rispetto a SoftwareVersion precedente. Se è maggiore, Windows esegue il software.

Nota

Per informazioni sui vincoli relativi a voci e valori SoftwareVersion, vedere SoftwareType.

SoftwareID={x.y.z}
Specifica un identificatore e un tipo di identificatore Microsoft Store. Attualmente è supportato solo il nome della famiglia di pacchetti (PFN). Usare un pfn per fare riferimento a un'app Piattaforma UWP (Universal Windows Platform) usando il formato pfn://<x.y.z>.

Nota

Per informazioni sui vincoli relativi a voci e valori SoftwareID, vedere SoftwareType.

Vedere anche

Uso di un file INF componente

Sezione INF DDInstall.Software

Direttiva INF AddComponent

Associazione di un driver a un'app UWP (Universal Windows Platform)

App di supporto hardware (HSA): passaggi per sviluppatori di driver

  • Ultimo aggiornamento: