Sezione INF DefaultInstall
Nota
Se si sta creando un pacchetto driver universale, questa sezione è valida solo se ha una decorazione dell'architettura, ad esempio [DefaultInstall.NTAMD64].
Nota
L'uso delle sezioni DefaultInstall e Manufacturer in INF causerà errori di convalida INF universali e può causare comportamenti di installazione incoerenti. Vedere Uso di un file INF universale.
Si accede alla sezione DefaultInstall di un file INF se un utente seleziona la voce di menu "Installa" dopo aver selezionato e tenuto premuto (o facendo clic con il pulsante destro del mouse) sul nome del file INF. In Windows 10 versione 1903 e successive di Windows è possibile usare un INF con DefaultInstall in molte API del pacchetto driver se soddisfa i requisiti di un driver primitivo.
[DefaultInstall] |
[DefaultInstall.nt] |
[DefaultInstall.ntx86] |
[DefaultInstall.ntia64] | (Windows XP and later versions of Windows)
[DefaultInstall.ntamd64] | (Windows XP and later versions of Windows)
[DefaultInstall.ntarm] | (Windows 8 and later versions of Windows)
[DefaultInstall.ntarm64] (Windows 10 version 1709 and later versions of Windows)
[CopyFiles=@filename | file-list-section[,file-list-section] ...]
[CopyINF=filename1.inf[,filename2.inf]...]
[AddReg=add-registry-section[,add-registry-section]...]
[Include=filename1.inf[,filename2.inf]...]
[Needs=inf-section-name[,inf-section-name]...]
[Delfiles=file-list-section[,file-list-section]...]
[Renfiles=file-list-section[,file-list-section]...]
[DelReg=del-registry-section[,del-registry-section]...]
[BitReg=bit-registry-section[,bit-registry-section]...]
[ProfileItems=profile-items-section[,profile-items-section]...]
[UpdateInis=update-ini-section[,update-ini-section]...]
[UpdateIniFields=update-inifields-section[,update-inifields-section]...]
[Ini2Reg=ini-to-registry-section[,ini-to-registry-section]...]
[RegisterDlls=register-dll-section[,register-dll-section]...]
[UnregisterDlls=unregister-dll-section[,unregister-dll-section]...] ...
Voci
Non tutte le voci valide sono supportate in un INF universale. Di seguito sono elencate le direttive valide in un INF universale e che non sono.
Supportato in un INF universale
CopyFiles=@filename | file-list-section[,file-list-section] ...
Questa direttiva facoltativa specifica un file denominato da copiare dal supporto di origine alla destinazione oppure fa riferimento a una o più sezioni definite dal writer INF che specificano i file da trasferire dal supporto di origine alla destinazione.
La voce DefaultDestDir nella sezione DestinationDirs di INF specifica la destinazione per qualsiasi singolo file da copiare. Le sezioni SourceDisksNames e SourceDisksFiles o un VALORE INF aggiuntivo specificato nella voce LayoutFile della sezione Version di questo INF specificare il percorso nel supporto di distribuzione dei file driver.
Per altre informazioni, vedere Direttiva COPYFiles INF.
CopyINF=filename1.inf[,filename2.inf]...
(Windows XP e versioni successive di Windows). Questa direttiva fa sì che i file INF specificati vengano copiati nel sistema di destinazione.
Per altre informazioni, vedere Direttiva INF CopyINF.
AddReg=add-registry-section[,add-registry-section]...
Questa direttiva fa riferimento a una o più sezioni definite dal writer INF in cui le nuove sottochiavi, possibilmente con voci di valore iniziale, vengono specificate per essere scritte nel Registro di sistema o in cui vengono modificate le voci di valore delle chiavi esistenti.
Per altre informazioni, vedere Direttiva INF AddReg.
Include=filename1.inf[,filename2.inf]...
Questa voce facoltativa specifica uno o più file INF forniti dal sistema aggiuntivi che contengono sezioni necessarie per installare il dispositivo e/o il driver. Se questa voce viene specificata, in genere è una voce Needs .
Ad esempio, i file INF di sistema per i driver di dispositivo che dipendono dal supporto del kernel-streaming del sistema specificano questa voce come indicato di seguito:
Include= ks.inf,kscaptur.inf,ksfilter.inf
Needs=inf-section-name[,inf-section-name]...
Questa voce facoltativa specifica le sezioni nei file INF forniti dal sistema che devono essere elaborati durante l'installazione di questo dispositivo. In genere, una sezione denominata è DDInstall (o DDInstall).xxx) sezione all'interno di uno dei file INF elencati in una voce Includi . Tuttavia, può trattarsi di qualsiasi sezione a cui viene fatto riferimento in tale DDInstall o DDInstall.xxx sezione dell'INF incluso.
Ad esempio, i file INF per i driver di dispositivo con la voce Includi precedente specificano questa voce come indicato di seguito:
Needs= KS.Registration,KSCAPTUR.Registration.NT,MSPCLOCK.Installation
Non supportato in un INF universale
Delfiles=file-list-section[,file-list-section]...
Questa direttiva fa riferimento a una o più sezioni definite dal writer INF che elencano i file nella destinazione da eliminare.
Per altre informazioni, vedere Direttiva INF DelFiles.
Renfiles=file-list-section[,file-list-section]...
Questa direttiva fa riferimento a una o più sezioni definite dal writer INF che elencano i file da rinominare nella destinazione prima che i file di origine pertinenti al dispositivo vengano copiati nel computer di destinazione.
Per altre informazioni, vedere Direttiva INF RenFiles.
DelReg=del-registry-section[,del-registry-section]...
Questa direttiva fa riferimento a una o più sezioni definite dal writer INF in cui vengono specificate chiavi e/o voci di valore da rimuovere dal Registro di sistema durante l'installazione dei dispositivi.
Per altre informazioni, vedere Direttiva INF DelReg.
BitReg=bit-registry-section[,bit-registry-section]...
Questa direttiva fa riferimento a una o più sezioni definite dal writer INF in cui vengono modificate le voci di valori del Registro di sistema esistenti di tipo REG_BINARY . Per altre informazioni, vedere Direttiva INF AddReg.
Per altre informazioni, vedere Direttiva INF BitReg.
ProfileItems=profile-items-section[,profile-items-section]...
Questa direttiva fa riferimento a una o più sezioni definite dal writer INF che descrivono gli elementi da aggiungere o rimuovere dal menu Start.
Per altre informazioni, vedere Direttiva INF ProfileItems.
UpdateInis=update-ini-section[,update-ini-section]...
Questa direttiva usata raramente fa riferimento a una o più sezioni definite dal writer INF, specificando un file INI di origine da cui una particolare sezione o riga all'interno di tale sezione deve essere letta in un file INI di destinazione con lo stesso nome durante l'installazione. Facoltativamente, le modifiche line-by-line a un file INI esistente nella destinazione da un file INI di origine specificato con lo stesso nome possono essere specificate nella sezione update-ini.
Per altre informazioni, vedere Direttiva INF UpdateInis.
UpdateIniFields=update-inifields-section[,update-inifields-section]...
Questa direttiva usata raramente fa riferimento a una o più sezioni definite dal writer INF in cui vengono specificate modifiche all'interno delle righe di un file INI specifico del dispositivo.
Per altre informazioni, vedere Direttiva INF UpdateIniFields.
Ini2Reg=ini-to-registry-section[,ini-to-registry-section]...
Questa direttiva usata raramente fa riferimento a una o più sezioni definite dal writer INF in cui sezioni o righe di un file INI specifico del dispositivo, fornito nel supporto di origine, devono essere spostate nel Registro di sistema.
Per altre informazioni, vedere Direttiva INF Ini2Reg.
RegisterDlls=register-dll-section[,register-dll-section]...
Questa direttiva fa riferimento a una o più sezioni INF usate per specificare i file che sono controlli OLE e richiedono la registrazione automatica.
Per altre informazioni, vedere Direttiva INF RegisterDlls.
UnregisterDlls=unregister-dll-section[,unregister-dll-section]...
Questa direttiva fa riferimento a una o più sezioni INF usate per specificare i file che sono controlli OLE e richiedono l'annullamento della registrazione automatica (rimozione automatica).
Per altre informazioni, vedere Direttiva INF UnregisterDlls.
Commenti
Le sezioni DefaultInstall non devono essere usate per le installazioni dei dispositivi. Usare le sezioni DefaultInstall solo per l'installazione di driver di filtro di classe, filtri del file system e servizi driver kernel non associati a un nodo del dispositivo (devnode).
Se si usa DefaultInstall in Windows 10 versione 1903 e versioni successive di Windows, è consigliabile che il file INF soddisfi i requisiti di un driver primitivo.
Nota
Il file INF di un pacchetto driver con una sezione Manufacturer non deve contenere una sezione INF DefaultInstall se il pacchetto driver deve essere firmato digitalmente. Per altre informazioni sulla firma dei pacchetti driver, vedere Firma driver.
Nota
A differenza di una sezione DDInstall , una sezione DefaultInstall non può contenere direttive DriverVer o LogConfig .
Per installare una sezione DefaultInstall da un'applicazione di installazione del dispositivo, usare la chiamata seguente a InstallHinfSection:
InstallHinfSection(NULL,NULL,TEXT("DefaultInstall 132 path-to-inf\infname.inf"),0);
Per altre informazioni su come usare le estensioni .nt, .ntx86, .ntia64, .ntamd64, ntarm e .ntarm64 definite dal sistema, vedere Creazione di file INF per più piattaforme e sistemi operativi.
Esempio
L'esempio seguente mostra una tipica sezione DefaultInstall :
[DefaultInstall]
CopyFiles=MyAppWinFiles, MyAppSysFiles, @SRSutil.exe
AddReg=MyAppRegEntries