Oddíl INF DDInstall
Každý oddíl
Oddíly odkazované těmito direktivami obsahují pokyny pro instalaci souborů ovladačů a zápis všech informací specifických pro konkrétní zařízení nebo ovladače do registru.
[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]
Položky
Ne všechny platné položky jsou podporovány v Univerzální INF. Následující seznamy uvádí, které direktivy jsou platné v univerzální inf a které nejsou platné.
Podporováno v univerzální inf
DriverVer=mm/dd/yyyy[,x.y.v.z]
Tato volitelná položka určuje informace o verzi balíčku ovladače .
Informace o tom, jak zadat tuto položku, naleznete v tématu INF DriverVer Direktiva.
CopyFiles=@název souboru | file-list-section[,file-list-section] ...
Tato direktiva buď určuje jeden pojmenovaný soubor, který se má zkopírovat ze zdrojového média do cíle, nebo odkazuje na jeden nebo více oddílů definovaných zápisem INF, ve kterých jsou soubory relevantní pro zařízení na zdrojovém médiu určené pro přenos do cíle. Direktiva CopyFiles je nepovinná, ale je k dispozici ve většině oddílů DDInstall.
Položka DefaultDestDir v části DestinationDirs inf určuje cíl pro každý jeden soubor, který se má zkopírovat. Oddíly SourceDisksNames a SourceDisksFiles nebo další inf specifikované v LayoutFile položky tohoto oddílu verze INF zadejte umístění na distribučním médiu souborů ovladačů.
Další informace naleznete v tématu INF CopyFiles – direktiva.
CopyINF=název souboru1.inf[,název_souboru2.inf]...
(Windows XP a novější) Tato direktiva způsobí zkopírování zadaných souborů INF do cílového systému.
Další informace naleznete v tématu INF CopyINF Direktiva.
AddReg=add-registry-section[,add-registry-section]...
Tato direktiva odkazuje na jeden nebo více oddílů definovaných zapisovačem INF, ve kterých jsou nové podklíče, pravděpodobně s počátečními položkami hodnot, zapsány do registru nebo ve kterých jsou změněny položky hodnot existujících klíčů.
Specifikace
Další informace najdete v tématu INF AddReg – direktiva.
AddProperty=add-property-section [,add-property-section]...
(Windows Vista a novější) Odkazuje na jeden nebo více oddílů souboru INF, které upravují vlastnosti zařízení, které jsou nastavené pro instanci zařízení. Měli byste použít INF AddProperty direktivu nastavit pouze vlastnost instance zařízení, která je nová ve Windows Vista nebo novějších verzích operačních systémů Windows.
Pro vlastnosti instance zařízení, které byly zavedeny dříve v systémech Windows Server 2003, Windows XP nebo Windows 2000 a které mají odpovídající hodnoty položek registru, byste měli nadále používat direktivy INF AddReg k nastavení vlastností instance zařízení. Tyto pokyny platí pro vlastnosti definované systémem a vlastní vlastnosti. Další informace o použití AddProperty direktivy naleznete v tématu Použití inf AddProperty direktivy a INF DelProperty direktivy.
Include=název souboru1.inf[,název_souboru2.inf]...
Tato volitelná položka určuje jeden nebo více souborů INF zadaných systémem, které obsahují oddíly potřebné k instalaci tohoto zařízení nebo ovladače. Pokud je tato položka zadaná, obvykle se jedná o položku Needs.
Například soubory INF pro ovladače zařízení, které závisí na podpoře streamování jádra systému, může tuto položku zadat takto:
Include= ks.inf, kscaptur.inf, ksfilter.inf
Needs=inf-section-name[,inf-section-name]...
Tato volitelná položka určuje oddíly v souborech INF zadaných systémem, které musí být zpracovány během instalace tohoto zařízení. Takový pojmenovaný oddíl je obvykle oddíl DDInstall (nebo DDInstall.xxx) v jednom ze souborů INF uvedených v Zahrnout položku. Může však být jakýkoli oddíl, na který odkazuje v rámci DDInstall nebo DDInstall.xxx část zahrnuté inf.
Například soubory INF pro ovladače zařízení, které mají předchozí Zahrnout položku, může tuto položku zadat takto:
Needs= KS.Registration, KSCAPTUR.Registration.NT, MSPCLOCK.Installation
FeatureScore=featurescore
Varování
Direktiva
(Windows Vista a novější) Tato direktiva poskytuje další kritérium řazení pro ovladače založené na funkcích, které ovladač podporuje. Například skóre funkcí může být definováno pro třídu nastavení zařízení , která rozlišuje ovladače na základě kritérií specifických pro třídu.
Další informace o tom, jak jsou ovladače seřazeny, naleznete v tématu Jak windows řadí ovladače (Windows Vista a novější).
Další informace o této směrnici naleznete v tématu INF FeatureScore direktiva.
Poznámka
I když oddíl DDInstall může obsahovat více položek FeatureScore, zpracuje se pro tento oddíl pouze první položka.
ExcludeID=device-identification-string[,device-identification-string]...
Varování
Direktiva ExcludeID se zpracuje pouze v sekci [DDInstall].
(Windows XP a novější) Tato direktiva určuje jeden nebo více identifikačních řetězců zařízení (id hardwaru
restartování
Tato direktiva označuje, že volající by měl být vyzván k restartování systému po dokončení instalace.
Další informace naleznete v tématu INF Reboot direktivy.
Nepodporuje se v univerzálním inf
Delfiles=file-list-section[,file-list-section]...
Tato direktiva odkazuje na jeden nebo více oddílů definovaných zápisem INF, které uvádějí soubory v cíli, které mají být odstraněny.
Další informace naleznete v tématu INF DelFiles – direktiva.
Renfiles=file-list-section[,file-list-section]...
Tato direktiva odkazuje na jeden nebo více oddílů definovaných zapisovačem INF, které mají být přejmenovány v cíli před zkopírování zdrojových souborů relevantních pro zařízení do cílového počítače.
Další informace najdete v tématu INF RenFiles – direktiva.
DelReg=del-registry-section[,del-registry-section]...
Tato direktiva odkazuje na jeden nebo více oddílů definovaných zápisem INF, ve kterých jsou klíče a/nebo položky hodnot určeny k odebrání z registru během instalace zařízení.
Tato direktiva se obvykle používá ke zpracování upgradů, když inf musí vyčistit staré položky registru z předchozí instalace tohoto zařízení.
Specifikace
Další informace naleznete v tématu INF DelReg – direktiva.
DelProperty=del-property-section[,del-property-section]...
(Windows Vista a novější) Odkazuje na jeden nebo více oddílů souboru INF, které odstraňují vlastnosti zařízení, které jsou nastavené pro instanci zařízení. Měli byste použít INF DelProperty direktivu pouze k odstranění vlastnosti instance zařízení, která je nová ve Windows Vista nebo novějších verzích Windows.
U vlastností instancí zařízení, které byly zavedeny dříve v systémech Windows Server 2003, Windows XP nebo Windows 2000 a které mají odpovídající hodnoty položek registru, byste měli dál používat direktiv INF DelReg k odstranění vlastností instance zařízení. Tyto pokyny platí pro vlastnosti definované systémem a vlastní vlastnosti. Další informace o použití direktivy DelProperty naleznete v tématu Použití inf AddProperty Direktiva a INF DelProperty směrnice.
Tato direktiva odkazuje na jeden nebo více oddílů definovaných zápisem INF, ve kterých jsou změněny existující položky hodnot registru typu REG_BINARY.
Specifikace
Další informace naleznete v tématu INF BitReg Direktiva.
LogConfig=log-config-section[,log-config-section]...
Tato direktiva odkazuje na jeden nebo více oddílů definovaných zapisovačem INF v rámci INF pro zařízení s kořenovým výčetm nebo pro ručně nainstalované zařízení. V těchto pojmenovaných oddílech inf pro takové "zjištěné" nebo ručně nainstalované zařízení určuje jednu nebo více logických konfigurací hardwarových prostředků relativních sběrnice, které musí být zařízení funkční. Inf pro takové ručně nainstalované zařízení, které není konfigurovatelné softwarem, by také mělo mít DDInstall. Oddíl factDef.
Direktiva LogConfig se nikdy nepoužívá k instalaci zařízení Plug and Play (PnP). Můžete však použít oddíl INF DDInstall.LogConfigOverride k poskytnutí konfigurace přepsání pro zařízení PnP.
Tato direktiva není pro všechny ovladače a komponenty vyšší úrovně relevantní.
Další informace naleznete v tématu INF LogConfig direktivy.
ProfileItems=profile-items-section[,profile-items-section]...
(Microsoft Windows 2000 a novější verze Windows) Tato zřídka použitá direktiva odkazuje na jeden nebo více oddílů definovaných zápisem INF, které popisují položky, které mají být přidány nebo odebrány z nabídky Start.
Další informace naleznete v tématu INF ProfileItems – direktiva.
UpdateInis=update-ini-section[,update-ini-section]...
Tato zřídka použitá direktiva odkazuje na jeden nebo více oddílů definovaných zápisem INF a určuje zdrojový soubor INI, ze kterého se má konkrétní oddíl nebo řádek v tomto oddílu číst do cílového souboru INI se stejným názvem během instalace. Volitelně je možné v části update-ini zadat úpravy existujícího souboru INI v cíli z daného zdrojového souboru INI se stejným názvem.
Další informace naleznete v tématu INF UpdateInis – direktiva.
UpdateIniFields=update-inifields-section[,update-inifields-section]...
Tato zřídka použitá direktiva odkazuje na jeden nebo více oddílů definovaných zápisem INF, ve kterých jsou zadány úpravy v řádcích souboru INI specifického pro zařízení.
Další informace naleznete v tématu INF UpdateIniFields – direktiva.
Ini2Reg=ini-to-registry-section [,ini-to-registry-section]...
Tato zřídka použitá direktiva odkazuje na jeden nebo více oddílů definovaných zápisem INF, ve kterých se oddíly nebo řádky ze souboru INI specifického pro zařízení dodaného na zdrojovém médiu mají přesunout do registru.
Další informace naleznete v tématu INF Ini2Reg směrnice.
RegisterDlls=register-dll-section[,register-dll-section]...
Tato direktiva odkazuje na jeden nebo více částí INF, které slouží k určení souborů, které jsou ovládacími prvky OLE a vyžadují samoobslužnou registraci.
Další informace naleznete v tématu INF RegisterDlls – direktiva.
UnregisterDlls=unregister-dll-section[,unregister-dll-section]...
Tato direktiva odkazuje na jeden nebo více částí INF, které slouží k určení souborů, které jsou ovládacími prvky OLE a vyžadují samoregistraci (self-removal).
Další informace naleznete v tématu INF UnregisterDlls – direktiva.
Poznámky
V dokumentaci k sadě Windows Driver Kit (WDK) se termín DDInstall používá k odkazování na název oddílu instalace , s rozšířeními platformy nebo bez. Proto "DDInstall section" znamená "pojmenovaný oddíl v inf, který má formát [install-section-name] nebo [install-section-name.ntxxx]". Při vytváření názvů oddílů DDInstall byste měli zahrnout předponu specifickou pro zařízení, například [WDMPNPB003_Device] nebo [GPR400. Install.NT].
Každý oddíl DDInstall musí být odkazován v položce specifické pro zařízení nebo modely v části podle výrobce INF Modely souboru INF.
S výjimkou zařízení, která nemají přidružené soubory k přenosu ze zdrojového média, musí mít soubor INF, který nainstaluje ovladač WDM na různé platformy operačního systému, alespoň jeden z následujících DDInstall oddíly:
- název oddílu instalaceoddílu .ntx86 oddílu, který určuje položky pro instalace zařízení a ovladačů specifické pro platformy založené na platformě x86.
- název oddílu instalaceoddílu .ntia64 oddílu, který určuje položky pro instalace zařízení a ovladačů specifické pro platformy s procesorem Itanium.
- název oddílu instalaceoddílu .ntamd64 oddílu, který určuje položky pro instalace zařízení a ovladačů specifické pro platformy založené na platformě x64.
- název oddílu instalaceoddílu .ntarm oddílu, který určuje položky pro instalace zařízení a ovladačů specifické pro platformy založené na arm.
- název oddílu instalaceoddílu .ntarm64 oddíl, který určuje položky pro instalace zařízení a ovladačů specifické pro platformy založené na Arm64.
- název oddílu instalace nebo install-section-nameoddílu .nt oddílu, který určuje položky pro instalace zařízení/ovladačů, které nejsou specifické pro konkrétní hardwarovou platformu.
Další informace o tom, jak používat systémově definované .nt, .ntx86, .ntia64, .ntamd64, .ntarma .ntarm64 rozšíření, viz Vytváření souborů INF pro více platforem a operačních systémů.
Počínaje systémem Windows 2000 musí mít soubor INF, který instaluje ovladače, oddíly DDInstall.Services k určení informací o službě ovladačů.
Každá direktiva v oddílu DDInstall může odkazovat na více než jeden název oddílu. Každý další pojmenovaný oddíl se ale musí oddělit od dalšího čárkou (,).
Každý název oddílu musí být v souboru INF jedinečný a musí dodržovat obecná pravidla pro definování názvů oddílů. Další informace o těchto pravidlech naleznete v tématu Obecné syntaktická pravidla pro soubory INF.
Všechny direktivy AddReg určené v oddílu DDInstall se předpokládá, že odkazuje na oddíl registru doplňků, který nelze použít k ukládání informací o ovladačích horního nebo dolního filtru, o multifunkčních zařízeních nebo o parametrech nezávislých na ovladačích, ale na parametrech specifických pro zařízení. Pokud musí INF zařízení/ovladač uložit tento typ informací v registru, musí použít direktivu
V závislosti na třídy nastavení zařízení, která byla zadána v oddílu VERZE INF, lze v části DDInstall zadat další direktivy specifické pro třídu. Další informace o direktivách specifických pro třídu najdete v následujících tématech:
- vytvoření souboru INF pro zařízení s Windows SideShow-Compatible
- oddíl DDInstall v souboru INF sítě
- soubory INF pro zařízení se stále imagemi
- soubory INF pro zařízení WIA
- požadavky na instalaci pro síťové komponenty
- určení direktiv WDF v souborech INF
Příklady
Tento příklad ukazuje rozšíření oddílů DDInstall, Ser_Inst a Inp_Inst. Tyto části jsou odkazovány v příkladu pro INF Modely oddíl.
[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
Následující příklad ukazuje oddíl DDInstall souboru INF, který nainstaluje systémový ovladač WDM pro zvukové zařízení na různých platformách operačního systému:
[WDMPNPB003_Device.NT]
Include=ks.inf, wdmaudio.inf
Needs=KS.Registration, WDMAUDIO.Registration.NT
CopyFiles=MSSB16.CopyList
AddReg=WDM_SB16.AddReg
Následující příklad ukazuje oddíly, na které odkazuje předchozí Needs položku v ks.inf a soubory wdmaudio.inf. V předchozím příkladu jsou tyto soubory zadány v Zahrnuje položku. Když instalační program zařízení operačního systému zpracuje název oddílu install-section.nt oddíl, tyto další dva oddíly se také zpracovávají.
[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
;
Viz také
DDInstall. FactDef
DDInstall. LogConfigOverride
DDInstall. služeb