Sezione INF DDInstall

Articolo
06/15/2023

Ogni sezione DDInstall per modello contiene una direttiva DriverVer facoltativa e una o più direttive che fanno riferimento a sezioni denominate aggiuntive nel file INF, illustrate di seguito con le direttive INF, CopyFiles e AddReg specificate più di frequente, 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 INF universale. Di seguito sono elencate le direttive valide in un INF universale e che non sono.

Supportato in un INF universale

DriverVer=mm/dd/aaaa[,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 file pertinenti per il dispositivo nel supporto di origine per il trasferimento alla destinazione. La direttiva CopyFiles è facoltativa, ma è presente nella maggior parte delle sezioni DDInstall .

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) 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.

Una specifica HKR in tale sezione del Registro di sistema designa il percorso del Registro di sistema "chiave software" del dispositivo in fase di installazione.

Per altre informazioni, vedere Direttiva INF AddReg.

AddProperty=add-property-section[,add-property-section]...
(Windows Vista e versioni successive) Fa riferimento a una o più sezioni di file INF che modificano le 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, è consigliabile continuare a usare le 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 sull'uso della direttiva AddProperty , vedere Using the INF AddProperty Directive and the INF DelProperty Directive.

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 kernel-streaming del sistema possono specificare questa voce come segue:

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 possono specificare questa voce come indicato di seguito:

Needs= KS.Registration, KSCAPTUR.Registration.NT, MSPCLOCK.Installation

FeatureScore=featurescore

Avviso

La direttiva FeatureScore viene elaborata solo se specificata direttamente nella sezione [DDInstall].

(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 delle funzionalità possono essere definiti per una classe di configurazione del dispositivo che distingue tra 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).For more information about how drivers are ranked, see How Windows Rank Drivers (Windows Vista and Later).

Per altre informazioni su questa direttiva, vedere Direttiva INF FeatureScore.

Nota

Anche se una sezione DDInstall può contenere più voci featureScore , solo la prima voce viene elaborata per la sezione.

ExcludeID=device-identification-string[,device-identification-string]...

Avviso

La direttiva ExcludeID viene elaborata solo se specificata direttamente nella sezione [DDInstall].

(Windows XP e versioni successive) Questa direttiva specifica una o più stringhe di identificazione del dispositivo ( ID hardware o ID compatibili). La sezione DDInstall non installa i dispositivi con ID dispositivo che corrispondono a uno qualsiasi degli ID hardware o id compatibili elencati.

Reboot
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=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.

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 HKR in tale sezione delete-registry designa il percorso del Registro di sistema "chiave software" 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 le 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, è consigliabile continuare a usare le 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 sull'uso della direttiva DelProperty , vedere Using the INF AddProperty Directive and the INF DelProperty Directive.

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 .

Una specifica HKR in tale sezione del Registro di sistema di bit definisce il percorso del Registro di sistema "chiave software" del dispositivo in fase di installazione.

Per altre informazioni, vedere Direttiva INF BitReg.

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 non viene mai usata per installare dispositivi Plug and Play (PnP). È tuttavia possibile usare una sezione INF DDInstall.LogConfigOverride per fornire una configurazione di override per i dispositivi PnP.

Questa direttiva è irrilevante per tutti i driver e i componenti di livello superiore (non dispositivo).

Per altre informazioni, vedere Direttiva INF LogConfig.

ProfileItems=profile-items-section[,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 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 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, 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'autoregistrazione (rimozione automatica).

Per altre informazioni, vedere Direttiva INF UnregisterDlls.

Commenti

In tutta la documentazione di Windows Driver Kit (WDK), il termine DDInstall viene usato per fare riferimento a un nome di sezione di installazione, 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 le sezioni DDInstall , è necessario includere un prefisso specifico del dispositivo, ad esempio [WDMPNPB003_Device] o [MDF400. Install.NT].

Ogni sezione DDInstall deve essere fatto riferimento a una voce specifica del dispositivo/modelli nella sezione Modelli INF per produttore del file INF.

Ad eccezione dei dispositivi che non hanno 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 DDInstall seguenti:

Sezione install-section-name.ntx86 che specifica le voci per le installazioni di dispositivi/driver specifiche per le piattaforme basate su x86.
Sezione install-section-name.ntia64 che specifica le voci per le installazioni di dispositivi/driver specifiche per le piattaforme basate su Itanium.
Sezione install-section-name.ntamd64 che specifica le voci per le installazioni di dispositivi/driver specifiche per le piattaforme basate su x64.
Sezione install-section-name.ntarm che specifica le voci per le installazioni di dispositivi/driver specifiche per le piattaforme basate su Arm.
Sezione install-section-name.ntarm64 che specifica le voci per le installazioni di dispositivi/driver specifiche per le piattaforme basate su Arm64.
Una sezione install-section-name o install-section-name.nt che specifica le voci per le installazioni di dispositivo/driver non specifiche di una determinata piattaforma hardware.

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.

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 generali per i file INF.

Si presuppone che qualsiasi direttiva AddReg specificata in una sezione DDInstall faccia riferimento a una sezione del Registro di sistema che non può essere usata per archiviare informazioni sui driver superiore o inferiore, sui dispositivi multifunzione o sui parametri indipendenti dal driver ma specifici del dispositivo. Se un dispositivo/driver INF deve archiviare questo tipo di informazioni nel Registro di sistema, deve usare una direttiva AddReg nel relativo DDInstall non decorato e decorato. Sezioni HW, se presenti, per fare riferimento a un'altra sezione del componente aggiuntivo definito dal writer INF.

A seconda della classe di installazione del dispositivo specificata nella sezione VERSIONE INF, è possibile specificare direttive specifiche della classe in una sezione DDInstall . Per altre informazioni sulle direttive specifiche della classe, vedere gli argomenti seguenti:

Esempio

In questo esempio viene illustrata l'espansione delle sezioni DDInstall , Ser_Inst e Inp_Inst. Queste sezioni vengono a cui si fa riferimento nell'esempio per la sezione Modelli INF.

[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

Nell'esempio seguente viene illustrata la sezione DDInstall di un file INF che installa un driver WDM fornito dal sistema per un dispositivo audio in varie piattaforme del sistema operativo:

[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 Esigenze precedente nei file ks.inf e wdmaudio.inf forniti dal sistema. Nell'esempio precedente, questi file vengono specificati nella voce Include . Quando il programma di installazione del dispositivo del sistema operativo elabora il nome install-section-name del dispositivo. La sezione nt , queste due sezioni successive vengono elaborate anche.

[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
;