INF UpdateIniFields-direktiv

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 UpdateIniFields-direktiv refererar till ett eller flera namngivna avsnitt där detaljerade ändringar inom raderna i en INI-fil kan anges.

[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)

UpdateIniFields=update-inifields-section[,update-inifields-section]...

Varje namngivet avsnitt som refereras till av ett UpdateIniFields-direktiv har följande formulär:

[update-inifields-section]
 
ini-file,ini-section,profile-name[,old-field][,new-field][,flags]
...

Ett update-inifields-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å en to-be-uppdaterad INI-fil 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 de angivna INI-filerna som innehåller raden som ska ändras.

profilnamn
Anger namnet på den rad som ska ändras i det angivna INI-avsnittet. Minst en av posterna old-field och/eller new-field måste anges för att genomföra en ändring av den här raden.

old-field
Anger ett befintligt fält inom den angivna raden. Om nytt fält utelämnas från den här avsnittsposten tas det här fältet bort från den angivna raden. Annars bör det angivna värdet för nytt fält ersätta det här fältet.

nytt fält
Anger en ersättning för ett angivet gammalt fält eller, om det gamla fältet utelämnas, ett tillägg till den angivna raden.

flags
Anger (i bit 0) hur det angivna gamla-fältet och/eller det nya-fältet ska tolkas om antingen eller båda innehåller en asterisk (*) och/eller (i bit 1) som avgränsartecken som ska användas när ett angivet nytt fält läggs till på den angivna raden enligt följande:

Bit noll = 0
Tolka alla asterisker (*) i angivna poster för gamla fält och/eller nya fält bokstavligen, inte som jokertecken, när du söker efter en matchning i den angivna raden i INI-filen. Detta är standardvärdet.

Bit noll = 1
Tolka alla asterisker (*) i angivna poster för gamla fält och/eller nya fält som jokertecken när du söker efter en matchning i den angivna raden i INI-filen.

Bit ett = 0
Använd ett blankstegstecken som avgränsare när du lägger till den angivna posten new-field till den angivna raden i INI-filen. Detta är standardvärdet.

Bit ett = 1
Använd ett kommatecken (,) som avgränsare när du lägger till den angivna posten new-field till den angivna raden i INI-filen.

Remarks

UpdateIniFields-direktivet anges nästan aldrig i INF-filer för installationer på Windows eftersom det inte är nödvändigt att ha INI-filer på deras distributionsmedia. UpdateIniFields-direktivet är dock giltigt i något av avsnitten som visas i den formella syntaxinstruktionen, samt i INF-skrivardefinierade avsnitt som refereras till av ett AddInterface-direktiv eller refereras till i ett InterfaceInstall32-avsnitt.

Varje update-inifields-section-namn måste vara unikt för INF-filen. Varje INF-skrivskyddat avsnittsnamn 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.

Till skillnad från ett avsnitt som refereras till av UpdateInis-direktivetersätter, lägger till eller tar bort delar av en rad i en befintlig INI-filrad i stället för att påverka hela värdet för en viss rad. Minst ett av värdena för det gamla fältet och/eller det nya fältet måste anges i varje avsnittspost.

Eventuella kommentarer på en to-be-ändrad INI-filrad tas bort eftersom de kanske inte är tillämpliga efter ändringar som gjorts enligt det här avsnittet. När du letar efter fält på raden i INI-filerna tolkas blanksteg, flikar och kommatecken som fältavgränsare. Ett blankstegstecken används dock som standardavgränsare när ett nytt fält läggs till på en rad.

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.

Se även

Lägg tillInterface

ClassInstall32

DDInstall

Ini2Reg

InterfaceInstall32

SourceDisksFiles

SourceDisksNames

Strängar

UpdateInis

Version