Sezione INF DDInstall
Ogni sezione DDInstall contiene una direttiva facoltativa DriverVer e una o più direttive che fanno riferimento a sezioni denominate aggiuntive nel file INF, illustrate di seguito con le direttive INF più frequenti, CopyFiles e AddReg, elencate per prime.
Le sezioni a cui fanno riferimento queste direttive contengono istruzioni per l'installazione dei file driver e la scrittura di informazioni specifiche del dispositivo e/o specifiche del driver nel Registro di sistema.
[install-section-name] |
[install-section-name.nt] |
[install-section-name.ntx86] |
[install-section-name.ntia64] | (Windows XP and later versions of Windows)
[install-section-name.ntamd64] | (Windows XP and later versions of Windows)
[install-section-name.ntarm] | (Windows 8 and later versions of Windows)
[install-section-name.ntarm64] (Windows 10 version 1709 and later versions of Windows)
[DriverVer=mm/dd/yyyy[,x.y.v.z]]
[CopyFiles=@filename | file-list-section[,file-list-section] ...]
[CopyINF=filename1.inf[,filename2.inf]...] (Windows XP and later versions of Windows)
[AddReg=add-registry-section[,add-registry-section]...]
[AddProperty=add-property-section[,add-property-section]...] (Windows Vista and later versions of Windows)
[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]...]
[DelProperty=del-property-section[,del-property-section]...] (Windows Vista and later versions of Windows)
[FeatureScore=featurescore]... (Windows Vista and later versions of Windows)
[BitReg=bit-registry-section[,bit-registry-section]...]
[LogConfig=log-config-section[,log-config-section]...]
[ProfileItems=profile-items-section[,profile-items-section]...] (Windows 2000 and later versions of Windows)
[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]...]
[ExcludeID=device-identification-string[,device-identification-string]...]... ((Windows XP and later versions of Windows)
[Reboot]
Voci
Non tutte le voci valide sono supportate in un Universal INF. Di seguito sono elencate le direttive valide in un INF universale e che non sono.
Supportato in un INF universale
DriverVer=mm/gg/aaaaa[,x.y.v.z]
Questa voce facoltativa specifica le informazioni sulla versione per il pacchetto driver .
Per informazioni su come specificare questa voce, vedere direttiva INF DriverVer.
CopyFiles=@filename | file-list-section[,file-list-section] ...
Questa direttiva specifica un file denominato da copiare dal supporto di origine alla destinazione o fa riferimento a una o più sezioni definite dal writer INF in cui vengono specificati i file pertinenti per il dispositivo nel supporto di origine per il trasferimento alla destinazione. La direttiva CopyFiles
La voce DefaultDestDir
Per altre informazioni, vedere direttiva COPYFiles INF.
CopyINF=filename1.inf[,filename2.inf]...
(Windows XP e versioni successive) 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, eventualmente 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.
Una specifica di HKR in una sezione del Registro di sistema di questo tipo designa il "chiave software" percorso del Registro di sistema del dispositivo in fase di installazione.
Per altre informazioni, vedere direttiva ADDReg INF.
AddProperty=add-property-section [,add-property-section]...
(Windows Vista e versioni successive) Fa riferimento a una o più sezioni di file INF che modificano proprietà del dispositivo impostate per un'istanza del dispositivo. È consigliabile usare una direttiva addProperty INF solo per impostare una proprietà dell'istanza del dispositivo nuova a Windows Vista o versioni successive dei sistemi operativi Windows.
Per le proprietà dell'istanza del dispositivo introdotte in precedenza in Windows Server 2003, Windows XP o Windows 2000 e con valori di voce del Registro di sistema corrispondenti, è necessario continuare a usare direttive INF AddReg per impostare le proprietà dell'istanza del dispositivo. Queste linee guida si applicano alle proprietà definite dal sistema e alle proprietà personalizzate. Per altre informazioni su come usare la direttiva AddProperty
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 per i driver di dispositivo che dipendono dal supporto del kernel-streaming del sistema possono specificare 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 all'interno dei file INF forniti dal sistema che devono essere elaborati durante l'installazione di questo dispositivo. In genere, una sezione denominata è una sezione DDInstall (o DDInstall.xxx) all'interno di uno dei file INF elencati in una voce Includi. Tuttavia, può essere qualsiasi sezione a cui viene fatto riferimento all'interno di tale DDInstall o DDInstall.sezione xxx dell'INF incluso.
Ad esempio, i file INF per i driver di dispositivo con il voce Includi precedente possono specificare questa voce come indicato di seguito:
Needs= KS.Registration, KSCAPTUR.Registration.NT, MSPCLOCK.Installation
FeatureScore=featurescore
Avvertimento
La direttiva FeatureScore
(Windows Vista e versioni successive) Questa direttiva fornisce un criterio di classificazione aggiuntivo per i driver basati sulle funzionalità supportate da un driver. Ad esempio, i punteggi di funzionalità possono essere definiti per una classe di configurazione del dispositivo che distingue i driver in base a criteri specifici della classe.
Per altre informazioni sulla classificazione dei driver, vedere Modalità di classificazione dei driver di Windows (Windows Vista e versioni successive).
Per altre informazioni su questa direttiva, vedere direttiva INF FeatureScore.
Nota
Anche se una sezione DDInstall
ExcludeID=device-identification-string [,device-identification-string]...
Avvertimento
La direttiva
(Windows XP e versioni successive) Questa direttiva specifica una o più stringhe di identificazione del dispositivo (ID hardware o ID compatibili ). La sezione DDInstall
di riavvio
Questa direttiva indica che al chiamante deve essere richiesto di riavviare il sistema al termine dell'installazione.
Per altre informazioni, vedere direttiva di riavvio INF.
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=sezione 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 le chiavi e/o le voci di valore vengono specificate per essere rimosse dal Registro di sistema durante l'installazione dei dispositivi.
In genere, questa direttiva viene usata per gestire gli aggiornamenti quando un INF deve pulire le voci precedenti del Registro di sistema da un'installazione precedente di questo dispositivo.
Una specifica di HKR in una sezione del Registro di sistema di eliminazione di questo tipo designa il "chiave software" percorso del Registro di sistema del dispositivo in fase di installazione.
Per altre informazioni, vedere direttiva INF DelReg.
DelProperty=del-property-section[,del-property-section]...
(Windows Vista e versioni successive) Fa riferimento a una o più sezioni di file INF che eliminano proprietà del dispositivo impostate per un'istanza del dispositivo. È consigliabile usare una direttiva INF DelProperty solo per eliminare una proprietà dell'istanza del dispositivo nuova a Windows Vista o versioni successive di Windows.
Per le proprietà dell'istanza del dispositivo introdotte in precedenza in Windows Server 2003, Windows XP o Windows 2000 e con valori di voce del Registro di sistema corrispondenti, è necessario continuare a usare direttive INF DelReg per eliminare le proprietà dell'istanza del dispositivo. Queste linee guida si applicano alle proprietà definite dal sistema e alle proprietà personalizzate. Per altre informazioni su come usare la direttiva
BitReg=sezione del Registro di sistema di bit [,sezione del Registro di sistema bit]...
Questa direttiva fa riferimento a una o più sezioni definite dal writer INF in cui vengono modificate le voci del valore del Registro di sistema esistenti di tipo REG_BINARY.
Una specifica HKR in una sezione del Registro di sistema di bit di questo tipo designa il "chiave software" percorso del Registro di sistema del dispositivo in fase di installazione.
Per altre informazioni, vedere direttiva BITReg INF.
LogConfig=log-config-section [,log-config-section]...
Questa direttiva fa riferimento a una o più sezioni definite dal writer INF all'interno di un INF per un dispositivo enumerato radice o per un dispositivo installato manualmente. In queste sezioni denominate, l'INF per un dispositivo "rilevato" o installato manualmente specifica una o più configurazioni logiche di risorse hardware relative al bus che il dispositivo deve essere operativo. L'INF per un dispositivo installato manualmente che non è configurabile dal software deve avere anche un DDInstall. Sezione FactDef.
La direttiva logconfig
Questa direttiva è irrilevante per tutti i driver e i componenti di livello superiore (non dispositivo).
Per altre informazioni, vedere direttiva LOGConfig INF.
ProfileItems=sezione profile-items [,profile-items-section]...
(Microsoft Windows 2000 e versioni successive di Windows) Questa direttiva usata raramente 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 utilizzata 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 determinato file INI di origine 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, fornite 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.
Osservazioni
In tutta la documentazione di Windows Driver Kit (WDK), il termine DDInstall viene usato per fare riferimento a un nome di install-section-name, con o senza estensioni della piattaforma. Pertanto, "sezione DDInstall" significa "una sezione denominata all'interno di un INF, con il formato [install-section-name] o [install-section-name.ntxxx]". Quando si creano nomi per sezioni di DDInstall, è necessario includere un prefisso specifico del dispositivo, ad esempio [WDMPNPB003_Device] o [ROUTE400. Install.NT].
A ogni sezione
Ad eccezione dei dispositivi che non dispongono di file associati da trasferire dal supporto di origine, un file INF che installa un driver WDM in piattaforme del sistema operativo diverse deve avere almeno una delle sezioni seguenti DDInstall:
- sezione install-section-namesezione .ntx86 sezione che specifica le voci per le installazioni di dispositivi/driver specifiche per le piattaforme basate su x86.
- sezione install-section-namesezione .ntia64 che specifica le voci per le installazioni di dispositivi/driver specifiche per le piattaforme basate su Itanium.
- sezione install-section-namesezione .ntamd64 sezione che specifica le voci per le installazioni di dispositivi/driver specifiche per le piattaforme basate su x64.
- sezione install-section-namesezione .ntarm che specifica le voci per le installazioni di dispositivi/driver specifiche per le piattaforme basate su Arm.
- sezione install-section-namesezione .ntarm64 sezione che specifica le voci per le installazioni di dispositivi/driver specifiche per le piattaforme basate su Arm64.
- sezione install-section-name o nome-sezione-installazionesezione .nt che specifica le voci per le installazioni di dispositivi/driver non specifiche di una determinata piattaforma hardware.
Per altre informazioni su come usare .nt, .ntx86, .ntia64, .ntamd64, .ntarme .ntarm64 estensioni, vedere Creazione di file INF per più piattaforme e sistemi operativi.
A partire da Windows 2000, un file INF che installa i driver deve avere sezioni DDInstall.Services per specificare le informazioni sul servizio driver.
Ogni direttiva in una sezione DDInstall può fare riferimento a più di un nome di sezione. Tuttavia, ogni sezione denominata aggiuntiva deve essere separata dalla successiva con una virgola (,).
Ogni nome di sezione deve essere univoco all'interno del file INF e deve seguire le regole generali per definire i nomi di sezione. Per altre informazioni su queste regole, vedere regole di sintassi generale per i file INF.
Qualsiasi direttiva AddReg specificata in una sezione DDInstall fa riferimento a una sezione del Registro di sistema del componente aggiuntivo che non può essere usata per archiviare informazioni sui driver di filtro superiore o inferiore, sui dispositivi multifunzione o sui parametri indipendenti dal driver ma specifici del dispositivo. Se un INF di dispositivo/driver deve archiviare questo tipo di informazioni nel Registro di sistema, deve usare una direttiva AddReg
A seconda della classe di installazione del dispositivo specificata nella sezione versione INF, è possibile specificare direttive specifiche della classe aggiuntive in una sezione DDInstall. Per altre informazioni sulle direttive specifiche della classe, vedere gli argomenti seguenti:
- Creazione di un file INF per un dispositivo Windows SideShow-Compatible
- sezione DDInstall in un file INF di rete
- file INF per i dispositivi ancora immagine
- file INF per dispositivi WIA
- requisiti di installazione per i componenti di rete
- specifica delle direttive WDF nei file INF
Esempi
In questo esempio viene illustrata l'espansione delle sezioni
[Ser_Inst]
CopyFiles=Ser_CopyFiles, mouclass_CopyFiles
[Ser_CopyFiles]
sermouse.sys
[mouclass_CopyFiles] ; section name referenced by > 1 CopyFiles
mouclass.sys
[Inp_Inst]
CopyFiles=Inp_CopyFiles, mouclass_CopyFiles
[Inp_CopyFiles]
inport.sys
L'esempio seguente illustra la sezione DDInstall
[WDMPNPB003_Device.NT]
Include=ks.inf, wdmaudio.inf
Needs=KS.Registration, WDMAUDIO.Registration.NT
CopyFiles=MSSB16.CopyList
AddReg=WDM_SB16.AddReg
Nell'esempio seguente vengono illustrate le sezioni a cui fa riferimento la voce
[KS.Registration]
; following AddReg= is actually a single line in the ks.inf file
AddReg=ProxyRegistration,CategoryRegistration,\
TopologyNodeRegistration,PlugInRegistration,PinNameRegistration,\
DeviceRegistration
CopyFiles=KSProxy.Files,KSDriver.Files
[WDMAUDIO.Registration.NT]
AddReg=WDM.AddReg
CopyFiles=WDM.CopyFiles.Sys, WDM.CopyFiles.Drv
;
; INF-writer-defined add-registry and file-list sections
; referenced by preceding directives are omitted here for brevity
;
Vedere anche
DDInstallare. coinstallatori
DDInstallare. LogConfigOverride
DDInstallare. dei servizi