Sezione INF DDInstall.HW
DDInstall. Le sezioni HW vengono in genere usate per l'installazione di dispositivi multifunzione, per l'installazione di driver di filtro PnP e per la configurazione di eventuali informazioni specifiche del dispositivo accessibili dall'utente, ma indipendenti dal driver nel Registro di sistema, sia con direttive AddReg esplicite o con voci Include e Needs .
[install-section-name.HW] |
[install-section-name.nt.HW] |
[install-section-name.ntx86.HW] |
[install-section-name.ntia64.HW] | (Windows XP and later versions of Windows)
[install-section-name.ntamd64.HW] | (Windows XP and later versions of Windows)
[install-section-name.ntarm.HW] | (Windows 8 and later versions of Windows)
[install-section-name.ntarm64.HW] (Windows 10 version 1709 and later versions of Windows)
[AddReg=add-registry-section[,add-registry-section]...] ...
[Include=filename.inf[,filename2.inf]...]
[Needs=inf-section-name[,inf-section-name]...]
[DelReg=del-registry-section[,del-registry-section]...] ...
[BitReg=bit-registry-section[,bit-registry-section] ...]
Voci
Non tutte le voci valide sono supportate in un INF universale. Gli elenchi seguenti elencano quali direttive sono valide in un INF universale e che non sono.
Supportato in un INF universale
AddReg=add-registry-section[,add-registry-section]...
Fa riferimento a una o più sezioni di componente aggiuntivo definite dal writer INF altrove nel file INF per i dispositivi coperti da questo DDInstall. Sezione HW . La sezione del componente aggiuntivo installa in genere filtri e/o archivia le informazioni per dispositivo nel Registro di sistema. Una specifica HKR in tale sezione del registro di sistema specifica la chiave hardware del dispositivo, una sottochiave del Registro di sistema specifica del dispositivo che contiene informazioni sul dispositivo. Una chiave hardware è chiamata anche chiave del dispositivo. Per altre informazioni, vedere Alberi del Registro di sistema e chiavi per dispositivi e driver. Un pacchetto driver può aggiungere impostazioni tramite inF usando una specifica HKR in una sezione del Registro di sistema a cui fa riferimento una sezione DDInstall.HW.
Per altre informazioni, vedere Direttiva INF AddReg.
Include=filename. inf[,filename2.inf]...
Specifica uno o più file INF forniti dal sistema aggiuntivi che contengono sezioni necessarie per installare questo dispositivo. Se questa voce viene specificata, in genere è una voce Esigenze .
Needs=inf-section-name[,inf-section-name]...
Specifica le sezioni denominate che devono essere elaborate durante l'installazione di questo dispositivo. In genere, tale sezione denominata è una DDInstall. Sezione HW all'interno di un file INF fornito dal sistema elencato in una voce Includi . Tuttavia, può essere qualsiasi sezione a cui si fa riferimento all'interno di tale DDInstall. Sezione HW dell'inF incluso.
Non supportato in un INF universale
DelReg=del-registry-section[,del-registry-section]...
Fa riferimento a una o più sezioni di eliminazionedefinite dal writer INF altrove nel file INF per i driver dei dispositivi coperti da questa sezione DDInstall . Questa sezione del Registro di sistema elimina le informazioni del Registro di sistema non aggiornate per un dispositivo/driver installato in precedenza dal computer di destinazione. Una specifica HKR in tale sezione del Registro di sistema di eliminazione designa la stessa sottochiave di addReg.
Questa direttiva viene raramente usata, ad eccezione di un file INF che aggiorna un'installazione precedente degli stessi dispositivi/modelli elencati nella sezione per produttore per modello che ha definito il nome di questa sezione DDInstall . Per altre informazioni, vedere Direttiva INF DelReg.
BitReg=bit-registry-section[,bit-registry-section] ...
È valido in questa sezione, ma quasi mai usato. Una specifica HKR in una sezione del Registro di sistema bit a cui si fa riferimento designa la stessa sottochiave di AddReg. Per altre informazioni, vedere Direttiva INF BitReg.
Commenti
Le estensioni senza distinzione tra maiuscole e minuscole al nome della sezione di installazione visualizzate nell'istruzione di sintassi formale possono essere inserite in tale DDInstall. Nome della sezione HW nei file INF multipiattaforma. 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.
Qualsiasi DDInstall. La sezione HW deve avere uno dei seguenti elementi:
- Direttiva AddReg .
- Voce Include che specifica un altro file INF. In questo caso, DDInstall. La sezione HW deve contenere anche una voce Esigenze corrispondente che specifica una sezione nell'altro file INF. Questa sezione viene usata per configurare le informazioni necessarie del Registro di sistema.
Ogni direttiva in una DDInstall. La sezione HW può fare riferimento a più sezioni definite dal writer INF. 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.
Per altre informazioni su come installare dispositivi multifunzione, vedere Supporto di dispositivi multifunzione.
Esempio
In questo esempio viene illustrato come un pacchetto driver può usare DDInstall. Sezioni HW e DDInstall. Sezioni dei servizi per aggiungere sia un driver di funzione che un driver di filtro superiore PnP.
[Example_DDInstall]
CopyFiles=example_copyfiles
[Example_DDInstall.HW]
AddReg=filter_addreg
[filter_addreg]
HKR,,"UpperFilters",0x00010000,"ExampleUpperFilter" ; [REG_MULTI_SZ](https://learn.microsoft.com/windows/desktop/SysInfo/registry-value-types) value
[Example_DDInstall.Services]
AddService=ExampleFunctionDriver,0x00000002,function_ServiceInstallSection
AddService=ExampleUpperFilter,,filter_ServiceInstallSection
[function_ServiceInstallSection]
DisplayName = %function_ServiceDesc%
ServiceType = 1
StartType = 3
ErrorControl = 1
ServiceBinary = %13%\ExampleFunctionDriver.sys
[filter_ServiceInstallSection]
DisplayName = %filter_ServiceDesc%
ServiceType = 1
StartType = 3
ErrorControl = 1
ServiceBinary = %13%\ExampleUpperFilter.sys