Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Caution
Från och med Windows 11 version 22H2 är ett drivrutinspaket som använder det här direktivet inte längre berättigat till en signatur från Hardware Developer Center.
Universella drivrutinspaket och Windows Drivrutiner kan inte använda det här direktivet.
Ett UpdateInis-direktiv refererar till ett eller flera namngivna avsnitt och anger en INI-fil från vilken ett visst avsnitt eller en viss rad ska läsas och tillämpas på en befintlig INI-fil med samma namn på måldatorn. Du kan också ange rad-för-rad-ändringar från och till sådana INI-filer i avsnittet update-ini-section.
[DDInstall] |
[DDInstall.CoInstallers] |
[ClassInstall32] |
[ClassInstall32.ntx86] |
[ClassInstall32.ntia64] | (Windows XP and later versions of Windows)
[ClassInstall32.ntamd64] | (Windows XP and later versions of Windows)
[ClassInstall32.ntarm] | (Windows 8 and later versions of Windows)
[ClassInstall32.ntarm64] (Windows 10 version 1709 and later versions of Windows)
UpdateInis=update-ini-section[,update-ini-section]...
Det här direktivet anges nästan aldrig i INF-filer för installation på Windows, på grund av bristen på nödvändighet för INI-filer. UpdateInis-direktivet är dock giltigt i något av avsnitten som visas i den formella syntaxsatsen, samt i INF-skrivardefinierade avsnitt som refereras till av ett AddInterface-direktiv eller refereras till i ett InterfaceInstall32-avsnitt.
Varje namngivet avsnitt som refereras till av ett UpdateInis-direktiv har följande formulär:
[update-ini-section]
ini-file,ini-section[,old-ini-entry][,new-ini-entry][,flags]
...
Ett update-ini-section kan ha valfritt INF-skrivarbestämt antal poster, var och en på en separat rad.
Inlägg
ini-file
Anger namnet på en INI-fil som anges på källmediet och implicit namnet på DEN INI-fil som ska uppdateras på måldatorn. Det här värdet kan uttryckas som ett filnamn eller som en %strkey -% token som definieras i avsnittet Strängar i INF-filen.
ini-section
Anger namnet på avsnittet i den angivna INI-filen. Om följande två värden anges innehåller det här avsnittet en post som ska ändras. Om en gammal ini-post utelämnas men en ny ini-post tillhandahålls, läggs den nya posten till när det här avsnittet läss.
old-ini-entry
Det här valfria värdet anger namnet på en post i det angivna ini-avsnittet, vanligtvis uttryckt i följande formulär:
"key=value"
Antingen eller både av nyckel och värde kan uttryckas som %strkey% token definieras i ett avsnitt med strängar i INF-filen. Asterisken (*) kan anges som ett jokertecken för antingen nyckeln eller värdet.
new-ini-entry
Det här valfria värdet anger antingen en ändring av en viss gammal ini-post eller tillägg av en ny post. Det här värdet kan uttryckas på samma sätt som old-ini-entry.
flags
Det här valfria värdet styr tolkningen av den angivna old-ini-entry och/eller new-ini-entry. Posten flaggor kan vara ett av följande numeriska värden:
| Value | Meaning |
|---|---|
| 0 | Det här är standardvärdet för flaggposten om den utelämnas. Om den angivna gamla ini-postnyckeln finns i INI-filerna ersätter du det värdet med den angivna nya ini-posten. Endast nycklarna i INI-filerna måste matcha. Motsvarande värde för varje sådan nyckel ignoreras. Om du vill lägga till en ny ini-post i INI-målfilen villkorslöst utelämnar du värdet old-ini-entry från posten i avsnittet update-ini i INF. Om du vill ta bort en gammal ini-post från INI-målfilen villkorslöst utelämnar du värdet new-ini-entry . |
| 1 | Om den angivna gamla ini-posten (key=value) finns i INI-filerna ersätter du den i mål-INI-filen som har den angivna nya ini-posten. Både nyckeln och värdet för den angivna gamla ini-posten måste matcha dem i INI-filerna för att en sådan ersättning ska kunna göras, inte bara deras nycklar som för föregående flaggvärde . |
| 2 | Om nyckeln som har angetts för old-ini-entry inte kan hittas i INI-målfilen gör du ingenting. I annat fall beror de ändringar som görs på matchningar som finns i INI-filerna för de givna nycklarna för gammal ini-post och ny ini-post enligt följande: (1) Om nyckeln för den gamla ini-posten finns i INI-filerna , men det gör även nyckeln för den nya ini-posten, ersätter du den gamla ini-posten med den nya ini-posten i INI-målfilen och tar sedan bort den överflödiga nya ini-posten från INI-filen . (2) Om nyckeln för den gamla ini-posten finns i INI-filerna, men nyckeln för den nya ini-posten inte gör det, ersätter du den gamla ini-entry-nyckeln med dennya ini-posten i ini-målfilen men lämnar värdet för den gamla ini-posten oförändrat. |
| 3 | Om nyckeln och värdet som angetts för old-ini-entry inte kan hittas i INI-filerna gör du ingenting. I annat fall beror de ändringar som görs på matchningar som finns i INI-filerna för de givna nycklarna och värdena för old-ini-entry och new-ini-entry enligt följande: (1) Om värdet för den gamla ini-posten finns i INI-filerna , men det gör även värdet för den nya ini-posten, ersätter du den gamla ini-posten med den nya ini-posten i INI-målfilen och tar sedan bort den överflödiga nya ini-posten från INI-filen . (2) Om värdet för den gamla ini-posten finns i INI-filerna , men inte den nya ini-posten , ersätter du den gamla ini-posten med den nya ini-posten i INI-målfilen men lämnar värdet för den gamla ini-posten oförändrat. |
Remarks
Ett angivet namn på update-ini-section måste vara unikt i INF-filen och måste följa de allmänna reglerna för att definiera avsnittsnamn. Mer information om dessa regler finns i Allmänna syntaxregler för INF-filer.
INF tillhandahåller den fullständiga sökvägen för den angivna ini-filen på distributionsmediet på något av följande sätt:
I INF-filer som tillhandahålls av IHV/OEM använder du avsnitten SourceDisksNames och SourceDisksFiles i inf-filen för att uttryckligen ange den fullständiga sökvägen för varje namngiven källfil som inte finns i rotkatalogen (eller katalogerna) på distributionsmediet.
Genom att ange en eller flera ytterligare INF-filer i INF-filer som tillhandahålls av systemet identifieras i posten LayoutFile i avsnittet Version i INF-filen.
Alla filnamn som anges i en gammal ini-post eller ny ini-post bör ange målkatalogen som innehåller filen. En sådan målkatalogsökväg för ett filnamn i en update-ini-section-post måste anges som ett dirid. Listor över möjliga diridvärden finns i Använda Dirids.