Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
A modellenkénti DDInstall szakasz tartalmaz egy választható DriverVer-irányelvet, valamint egy vagy több, az INF-fájlban található további elnevezett szakaszokra hivatkozó irányelveket, itt láthatók a leggyakrabban megadott INF-irányelvek, CopyFiles és AddReg, elsőként felsorolva.
Az ezen irányelvekben hivatkozott szakaszok útmutatást tartalmaznak az illesztőprogram-fájlok telepítéséhez és az eszközspecifikus és/vagy illesztőprogram-specifikus információk beállításjegyzékbe való írásához.
[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]
Bejegyzések
Nem minden érvényes bejegyzés támogatott egy univerzális INF. Az alábbi lista felsorolja, hogy mely irányelvek érvényesek az univerzális INF-ben, és melyek nem.
Univerzális INF-ben támogatott
DriverVer=mm/dd/yyyyy[,x.y.v.z]
Ez az opcionális bejegyzés a illesztőprogram-csomagverzióadatait adja meg.
A bejegyzés megadásáról további információt INF DriverVer-irányelv.
CopyFiles=@filename | file-list-section[,file-list-section] ...
Ez az irányelv vagy megad egy elnevezett fájlt, amelyet a forrás adathordozóról a célhelyre szeretne másolni, vagy egy vagy több INF-író által definiált szakaszra hivatkozik, amelyekben a forrás adathordozón lévő eszközre vonatkozó fájlok a célhelyre való átvitelhez vannak megadva. A CopyFiles irányelv nem kötelező, de a legtöbb DDInstall szakaszban megtalálható.
A DefaultDestDir bejegyzés az INF DestinationDirs szakaszában megadja a másolandó fájlok célhelyét. A
További információ: INF CopyFiles irányelv.
CopyINF=filename1.inf[,filename2.inf]...
(Windows XP és újabb verziók) Ez az irányelv a megadott INF-fájlokat a célrendszerbe másolja.
További információ: INF CopyINF irányelv.
AddReg=add-registry-section[,add-registry-section]...
Ez az irányelv egy vagy több INF-író által definiált szakaszra hivatkozik, amelyekben az új alkulcsokat, amelyek esetleg kezdeti értékbejegyzésekkel vannak megadva, a beállításjegyzékbe kell írni, vagy amelyekben a meglévő kulcsok értékbejegyzései módosulnak.
Az ilyen bővítményregisztrációs szakaszban található HKR- specifikáció a telepített eszköz "szoftverkulcs" beállításjegyzék elérési útját jelöli meg.
További információ: INF AddReg irányelv.
AddProperty=add-property-section[,add-property-section]...
(Windows Vista és újabb verziók) Egy vagy több inf fájlszakaszra hivatkozik, amelyek módosítják eszköztulajdonságokat, amelyek egy eszközpéldányhoz vannak beállítva. Az INF AddProperty irányelv csak a Windows Vista vagy a Windows operációs rendszerek újabb verzióiban új eszközpéldány-tulajdonság beállításához használható.
A Windows Server 2003, Windows XP vagy Windows 2000 rendszeren korábban bevezetett és a beállításjegyzék megfelelő bejegyzési értékeivel rendelkező eszközpéldány-tulajdonságok esetében továbbra is INF AddReg-irányelvek kell használnia az eszközpéldány tulajdonságainak beállításához. Ezek az irányelvek a rendszer által meghatározott tulajdonságokra és egyéni tulajdonságokra vonatkoznak. Az AddProperty irányelv használatáról további információt az Inf AddProperty irányelv és az INF DelProperty irányelvcímű témakörben talál.
Include=filename1.inf[,filename2.inf]...
Ez az opcionális bejegyzés egy vagy több további, rendszer által biztosított INF-fájlt ad meg, amely az eszköz és/vagy illesztőprogram telepítéséhez szükséges szakaszokat tartalmazza. Ha ez a bejegyzés meg van adva, általában egy bejegyzésre van szükség.
Például a rendszer kernelstreamelési támogatásától függő eszközillesztők INF-fájljai az alábbiak szerint adhatják meg ezt a bejegyzést:
Include= ks.inf, kscaptur.inf, ksfilter.inf
Needs=inf-section-name[,inf-section-name]...
Ez az opcionális bejegyzés a rendszer által biztosított INF-fájlok azon szakaszait határozza meg, amelyeket az eszköz telepítése során fel kell dolgozni. Az ilyen elnevezett szakasz általában egy DDInstall (vagy DDInstall.xxx) szakasz az Belefoglalás bejegyzésben felsorolt INF-fájlok egyikében. Azonban bármely olyan szakasz lehet, amely egy ilyen DDInstall vagy DDInstall.beépített INF xxx szakasza.
Az előző Include bejegyzéssel rendelkező eszközillesztők INF-fájljai például az alábbiak szerint adhatják meg ezt a bejegyzést:
Needs= KS.Registration, KSCAPTUR.Registration.NT, MSPCLOCK.Installation
FeatureScore=featurecore
Figyelmeztetés
A FeatureScore irányelv csak akkor lesz feldolgozva, ha közvetlenül a [DDInstall] szakaszban van megadva.
(Windows Vista és újabb verziók) Ez az irányelv egy további rangsorolási feltételt biztosít az illesztőprogramok számára, amelyek az illesztőprogram által támogatott funkciókon alapulnak. Előfordulhat például, hogy egy eszközbeállítási osztályhoz funkciópontszámokat határoz meg, amelyek osztályspecifikus feltételek alapján különböztetik meg az illesztőprogramokat.
További információ az illesztőprogramok rangsorolásáról: Hogyan rangsorolja a Windows Illesztőprogramok (Windows Vista és Újabb).
További információ erről az irányelvről: INF FeatureScore irányelv.
Jegyzet
Bár egy DDInstall szakasz több FeatureScore bejegyzést is tartalmazhat, a szakaszhoz csak az első bejegyzés lesz feldolgozva.
ExcludeID=device-identification-string[,device-identification-string]...
Figyelmeztetés
A ExcludeID irányelv csak akkor lesz feldolgozva, ha közvetlenül a [DDInstall] szakaszban van megadva.
(Windows XP és újabb verziók) Ez az irányelv egy vagy több eszközazonosítási sztringet határoz meg (hardverazonosítókat vagy kompatibilis azonosítókat). A DDInstall szakasz nem telepíti azokat az eszközöket, amelyek eszközazonosítókkal, amelyek megfelelnek a felsorolt hardverazonosítóknak vagy kompatibilis azonosítóknak.
újraindítási
Ez az irányelv azt jelzi, hogy a hívónak a telepítés befejezése után újra kell indítania a rendszert.
További információ: INF újraindítási irányelv.
Univerzális INF-ben nem támogatott
Delfiles=file-list-section[,file-list-section]...
Ez az irányelv egy vagy több INF-író által definiált szakaszra hivatkozik, amelyek a törölni kívánt célfájlokat sorolják fel.
További információ: INF DelFiles irányelv.
Renfiles=file-list-section[,file-list-section]...
Ez az irányelv egy vagy több INF-író által definiált szakaszra hivatkozik, amelyek a célhelyen átnevezendő fájlokat sorolják fel, mielőtt az eszközre vonatkozó forrásfájlokat átmásolják a célszámítógépre.
További információ: INF RenFiles irányelv.
DelReg=del-registry-section[,del-registry-section]...
Ez az irányelv egy vagy több INF-író által definiált szakaszra hivatkozik, amelyekben kulcsok és/vagy értékbejegyzések vannak megadva, amelyeket az eszközök telepítésekor el kell távolítani a beállításjegyzékből.
Ez az irányelv általában a frissítések kezelésére szolgál, amikor egy INF-nek törölnie kell az eszköz korábbi telepítéséből származó régi beállításjegyzék-bejegyzéseket.
Az ilyen törlési beállításjegyzék-szakaszban található HKR specifikáció a telepített eszköz "szoftverkulcsot" beállításjegyzék elérési útját jelöli meg.
További információ: INF DelReg-irányelv.
DelProperty=del-property-section[,del-property-section]...
(Windows Vista és újabb verziók) Egy vagy több OLYAN INF-fájlszakaszra hivatkozik, amely törli eszköztulajdonságokat, amelyek egy eszközpéldányhoz vannak beállítva. Az INF DelProperty-irányelv csak a Windows Vista vagy a Windows újabb verzióiban új eszközpéldány-tulajdonság törlésére használható.
A Windows Server 2003, Windows XP vagy Windows 2000 rendszeren korábban bevezetett és a megfelelő beállításjegyzékbejegyzési értékekkel rendelkező eszközpéldány-tulajdonságok esetében továbbra is INF DelReg-irányelvek kell használnia az eszközpéldány tulajdonságainak törléséhez. Ezek az irányelvek a rendszer által meghatározott tulajdonságokra és egyéni tulajdonságokra vonatkoznak. Az DelProperty irányelv használatáról további információt az Inf AddProperty irányelv és az INF DelProperty irányelvcímű cikkben talál.
BitReg=bitregisztrációs szakasz[,bitregisztrációs szakasz]...
Ez az irányelv egy vagy több INF-író által definiált szakaszra hivatkozik, amelyekben a meglévő beállításjegyzék-értékek REG_BINARY típusú bejegyzéseket módosítanak.
Az ilyen bitregisztrációs szakaszban található HKR- specifikáció a telepített eszköz "szoftverkulcsot" beállításjegyzék elérési útját jelöli.
További információ: INF BitReg irányelv.
LogConfig=log-config-section[,log-config-section]...
Ez az irányelv egy vagy több INF-író által definiált szakaszra hivatkozik az INF-ben egy root-enumerált eszközhöz vagy egy manuálisan telepített eszközhöz. Ezekben a nevesített szakaszokban az ilyen "észlelt" vagy manuálisan telepített eszközök INF-jének egy vagy több logikai konfigurációt kell megadnia azoknak a busz relatív hardvererőforrásoknak, amelyeknek az eszköznek működőképesnek kell lenniük. Az ilyen manuálisan telepített, nem szoftveresen konfigurálható eszközök INF-jének DDInstallis rendelkeznie kell. FactDef szakasz.
A LogConfig irányelv soha nem használható Plug and Play (PnP) eszközök telepítéséhez. Használhat azonban egy INF DDInstall.LogConfigOverride szakaszt a PnP-eszközök felülbírálási konfigurációjának megadásához.
Ez az irányelv minden magasabb szintű (nem kiürített) illesztőprogram és összetevő szempontjából irreleváns.
További információ: INF LogConfig-irányelv.
ProfileItems=profile-items-section[,profile-items-section]...
(A Windows Microsoft Windows 2000 és újabb verziói) Ez a ritkán használt irányelv egy vagy több INF-író által definiált szakaszra hivatkozik, amelyek a Start menühöz hozzáadandó vagy eltávolítandó elemeket ismertetik.
További információ: INF ProfileItems irányelv.
UpdateInis=update-ini-section[,update-ini-section]...
Ez a ritkán használt irányelv egy vagy több INF-író által definiált szakaszra hivatkozik, meghatározva egy forrás INI-fájlt, amelyből egy adott szakaszt vagy sort be kell olvasni egy azonos nevű cél INI-fájlba a telepítés során. Igény szerint a frissítési ini szakaszban megadható egy meglévő INI-fájl soronkénti módosítása a célhelyen egy azonos nevű forrás INI-fájlból.
További információ: INF UpdateInis irányelv.
UpdateIniFields=update-inifields-section[,update-inifields-section]...
Ez a ritkán használt irányelv egy vagy több INF-író által definiált szakaszra hivatkozik, amelyekben az eszközspecifikus INI-fájlok soraiban lévő módosítások vannak megadva.
További információ: INF UpdateIniFields irányelv.
Ini2Reg=ini-to-registry-section[,ini-to-registry-section]...
Ez a ritkán használt irányelv egy vagy több INF-író által definiált szakaszra hivatkozik, amelyekben a forrás adathordozón megadott eszközspecifikus INI-fájl szakaszait vagy sorait át kell helyezni a beállításjegyzékbe.
További információ: INF Ini2Reg irányelv.
RegisterDlls=register-dll-section[,register-dll-section]...
Ez az irányelv egy vagy több INF-szakaszra hivatkozik, amelyek OLE-vezérlők és önregisztrációt igénylő fájlok megadására szolgálnak.
További információ: INF RegisterDlls irányelv.
UnregisterDlls=unregister-dll-section[,unregister-dll-section]...
Ez az irányelv egy vagy több INF-szakaszra hivatkozik, amelyek OLE-vezérlőket tartalmazó fájlok megadására szolgálnak, és önregisztrációt (öneltávolítást) igényelnek.
További információ: INF UnregisterDlls irányelv.
Megjegyzések
A Windows Driver Kit (WDK) dokumentációjában a DDInstall kifejezés egy telepítési szakasznévhivatkozik platformbővítményekkel vagy anélkül. Ezért a "DDInstall szakasz" azt jelenti, hogy "egy INF-ben lévő elnevezett szakasz, amelynek formátuma [install-section-name] vagy [install-section-name.ntxxx]". Ha DDInstall szakaszokhoz hoz létre neveket, egy eszközspecifikus előtagot kell tartalmaznia, például [WDMPNPB003_Device] vagy [GPR400. Install.NT].
Minden DDInstall szakaszra az INF-fájl gyártónkénti INF Modellek szakaszában kell hivatkozni.
Azon eszközök kivételével, amelyek nem rendelkeznek a forrás adathordozóról átvitt fájlokkal, a WDM-illesztőprogramokat különböző operációsrendszer-platformokon telepítő INF-fájloknak legalább az alábbi DDInstall szakaszok egyikével kell rendelkezniük:
- Egy telepítési szakasznév.ntx86 szakasz, amely megadja az x86-alapú platformokra vonatkozó eszköz-/illesztőprogram-telepítések bejegyzéseit.
- Egy install-section-name.ntia64 szakasz, amely az Itanium-alapú platformokra vonatkozó eszköz-/illesztőprogram-telepítések bejegyzéseit határozza meg.
- Egy telepítési szakasznév.ntamd64 szakasz, amely megadja az x64-alapú platformokra vonatkozó eszköz-/illesztőprogram-telepítés bejegyzéseit.
- Egy telepítési szakasznév.ntarm szakasz, amely az Arm-alapú platformokra vonatkozó eszköz-/illesztőprogram-telepítések bejegyzéseit adja meg.
- Egy telepítési szakasznév.ntarm64 szakasz, amely megadja az Arm64-alapú platformokra vonatkozó eszköz-/illesztőprogram-telepítések bejegyzéseit.
- Egy install-section-name vagy install-section-name.nt szakasz, amely meghatározza a nem egy adott hardverplatformra jellemző eszköz-/illesztőprogram-telepítés bejegyzéseit.
További információ a rendszer által definiált .nt, .ntx86, .ntia64, .ntamd64, .ntarmés .ntarm64 bővítmények használatáról, lásd: INF-fájlok létrehozása több platformhoz és operációs rendszerhez.
A Windows 2000-től kezdődően az illesztőprogramokat telepítő INF-fájloknak DDInstall.Services szakaszokkal kell rendelkezniük az illesztőprogram-szolgáltatás adatainak megadásához.
A DDInstall szakasz egyes irányelveinek több szakasznévre is hivatkozhatnak. Minden további elnevezett szakaszt azonban vesszővel (,) kell elválasztani a következőtől.
Minden szakasznévnek egyedinek kell lennie az INF-fájlban, és be kell tartania a szakasznevek meghatározására vonatkozó általános szabályokat. További információ ezekről a szabályokról: INF-fájlok általános szintaxisszabályai.
A DDInstall szakaszban megadott AddReg direktíva olyan bővítményregisztrációs szakaszra hivatkozik, amely nem használható a felső vagy az alsó szűrőű illesztőprogramokra, a többfunkciós eszközökre vagy az illesztőprogram-független, de eszközspecifikus paraméterekre vonatkozó információk tárolására. Ha egy eszköz/illesztőprogram INF-jének ilyen típusú adatokat kell tárolnia a beállításjegyzékben, akkor a AddReg direktívát kell használnia a nemcorated és a dekorált DDInstall. HW szakaszokat, ha vannak ilyenek, egy másik INF-író által definiált add-registry-sectionhivatkozni.
A
- INF-fájl létrehozása Windows SideShow-Compatible-eszköz
- hálózati INF-fájl DDInstall szakasza
- INF-fájlok állókép-eszközökhöz
- INF-fájlok WIA-eszközökhöz
- hálózati összetevőkre vonatkozó telepítési követelmények
- WDF-irányelvek meghatározása az INF-fájlokban
Példák
Ez a példa a DDInstall szakaszok, Ser_Inst és Inp_Instbővítését mutatja be. Ezekre a szakaszokra a INF Modellek szakasz.
[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
Az alábbi példa egy INF-fájl DDInstall szakaszát mutatja be, amely egy hangeszközhöz rendszer által biztosított WDM-illesztőt telepít különböző operációsrendszer-platformokon:
[WDMPNPB003_Device.NT]
Include=ks.inf, wdmaudio.inf
Needs=KS.Registration, WDMAUDIO.Registration.NT
CopyFiles=MSSB16.CopyList
AddReg=WDM_SB16.AddReg
Az alábbi példa a rendszer által biztosított ks.inf és wdmaudio.inf fájlokban az előző Szükséges bejegyzés által hivatkozott szakaszokat mutatja be. Az előző példában ezek a fájlok a Tartalmaz bejegyzésben vannak megadva. Amikor az operációs rendszer eszköztelepítője feldolgozza az eszköz telepítési szakasznév.nt szakaszt is feldolgozzuk.
[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
;