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. Di seguito sono elencate le direttive 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 del Registro di sistema definite dal writer INF altrove nel file INF per i dispositivi coperti da questa DDInstall. Sezione HW . La sezione add-registry installa in genere filtri e/o archivia le informazioni per dispositivo nel Registro di sistema. Una specifica HKR in tale sezione add-registry-section specifica la chiave hardware del dispositivo, una sottochiave del Registro di sistema specifica del dispositivo che contiene informazioni sul dispositivo. Una chiave hardware è detta anche chiave del dispositivo. Per altre informazioni, vedi Alberi e chiavi del Registro di sistema per dispositivi e driver. Un pacchetto driver può aggiungere impostazioni tramite un INF usando una specifica HKR in una sezione del registro dei componenti aggiuntivi 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 il dispositivo. Se questa voce viene specificata, in genere è una voce Needs .

Needs=inf-section-name[,inf-section-name]...
Specifica le sezioni denominate che devono essere elaborate durante l'installazione di questo dispositivo. In genere, una sezione denominata è DDInstall. Sezione HW all'interno di un file INF fornito dal sistema elencato in una voce Includi . Tuttavia, può essere qualsiasi sezione a cui viene fatto 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 delete-registry-definedinF-defined in un'altra posizione nel file INF per i driver dei dispositivi coperti da questa sezione DDInstall . Questa sezione delete-registry rimuove le informazioni del Registro di sistema non aggiornate per un dispositivo/driver installato in precedenza dal computer di destinazione. Una specifica HKR in una sezione del registro di eliminazione definisce la stessa sottochiave di AddReg.

Questa direttiva viene usata raramente, tranne in un file INF che aggiorna un'installazione precedente degli stessi dispositivi/modelli elencati nella sezione per produttore per ogni 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 definisce la stessa sottochiave di AddReg. Per altre informazioni, vedere Direttiva INF BitReg.

Remarks

Le estensioni senza distinzione tra maiuscole e minuscole per il nome install-section indicato nell'istruzione di sintassi formale possono essere inserite in un DDInstall di questo tipo. 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 Di inclusione che specifica un altro file INF. In questo caso, DDInstall. La sezione HW deve contenere anche una voce Needs corrispondente che specifica una sezione nell'altro file INF. Questa sezione viene usata per configurare le informazioni del Registro di sistema necessarie.

Ogni direttiva in un DDInstall. La sezione HW può fare riferimento a più sezioni INF-writer-defined. 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.

Esempi

Questo esempio mostra 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

Vedere anche

AddReg

BitReg

DDInstall

DDInstall.Services

DelReg