Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Caution
Vanaf Windows 11 versie 22H2 komt een stuurprogrammapakket met deze richtlijn niet meer in aanmerking voor een handtekening van Hardware Developer Center.
Universele stuurprogrammapakketten en Windows Drivers kunnen deze richtlijn niet gebruiken.
Een UpdateInis-instructie verwijst naar een of meer benoemde secties, waarbij een INI-bestand wordt opgegeven waaruit een bepaalde sectie of regel moet worden gelezen en toegepast op een bestaand INI-bestand met dezelfde naam op de doelcomputer. Desgewenst kunnen wijzigingen van en naar dergelijke INI-bestanden worden opgegeven in de update-ini-sectie.
[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]...
Deze richtlijn wordt bijna nooit gespecificeerd in INF-bestanden voor installatie op Windows, vanwege het gebrek aan noodzaak voor INI-bestanden. De UpdateInis-instructie is echter geldig in een van de secties die worden weergegeven in de formele syntaxisinstructie, evenals in inF-writer-gedefinieerde secties waarnaar wordt verwezen door een AddInterface-instructie of waarnaar wordt verwezen in een InterfaceInstall32-sectie .
Elke benoemde sectie waarnaar wordt verwezen door een UpdateInis-instructie heeft de volgende vorm:
[update-ini-section]
ini-file,ini-section[,old-ini-entry][,new-ini-entry][,flags]
...
Een update-ini-section kan elk inF-writer-bepaald aantal vermeldingen bevatten, elk op een afzonderlijke regel.
Invoer
ini-file
Hiermee geeft u de naam op van een INI-bestand dat is opgegeven op de bronmedia en impliciet dat van het INI-bestand moet worden bijgewerkt op de doelcomputer. Deze waarde kan worden uitgedrukt als een bestandsnaam of als een %strkey% token dat is gedefinieerd in een tekenreekssectie van het INF-bestand.
ini-section
Hiermee geeft u de naam van de sectie in het opgegeven INI-bestand. Als de volgende twee waarden zijn opgegeven, bevat deze sectie een vermelding die moet worden gewijzigd. Als een old-ini-entry wordt weggelaten, maar er een nieuw-ini-item wordt opgegeven, wordt de nieuwe vermelding toegevoegd terwijl deze sectie wordt gelezen.
old-ini-entry
Deze optionele waarde geeft de naam op van een vermelding in de opgegeven ini-sectie, meestal uitgedrukt in de volgende vorm:
"key=value"
Sleutel enwaarde kunnen worden uitgedrukt als %strkey% tokens die zijn gedefinieerd in een sectie Tekenreeksen van het INF-bestand. Het sterretje (*) kan worden opgegeven als een jokerteken voor de sleutel of de waarde.
new-ini-entry
Met deze optionele waarde wordt een wijziging opgegeven in een bepaalde oude ini-vermelding of de toevoeging van een nieuwe vermelding. Deze waarde kan op dezelfde manier worden uitgedrukt als old-ini-entry.
flags
Deze optionele waarde bepaalt de interpretatie van de opgegeven old-ini-entry en/of new-ini-entry. De vlagvermelding kan een van de volgende numerieke waarden zijn:
| Value | Meaning |
|---|---|
| 0 | Dit is de standaardwaarde voor de vlagvermelding als deze wordt weggelaten. Als de opgegeven old-ini-entry-sleutel aanwezig is in de INI-bestanden, vervangt u die sleutel=waarde door de opgegeven new-ini-entry. Alleen de sleutels in de INI-bestanden moeten overeenkomen. De bijbehorende waarde van elke dergelijke sleutel wordt genegeerd. Als u een nieuwe ini-vermelding wilt toevoegen aan het INI-doelbestand, laat u de waarde van de oude ini-vermelding weg uit de vermelding in de sectie update-ini van het INF. Als u een oude ini-vermelding wilt verwijderen uit het DOEL-INI-bestand, laat u de waarde voor nieuwe ini-vermelding weg. |
| 1 | Als de opgegeven old-ini-entry (key=value) bestaat in de INI-bestanden, vervangt u deze in het doel-INI-bestand met de opgegeven nieuwe ini-vermelding. Zowel de sleutel als de waarde van de opgegeven old-ini-vermelding moeten overeenkomen met die in de INI-bestanden, zodat een dergelijke vervanging moet worden gemaakt, niet alleen de sleutels zoals voor de voorgaande vlagwaarde . |
| 2 | Als de sleutel die is opgegeven voor old-ini-entry niet kan worden gevonden in het DOEL INI-bestand, doet u niets. Anders zijn de aangebrachte wijzigingen afhankelijk van overeenkomsten in de INI-bestanden voor de opgegeven sleutels van old-ini-entry en new-ini-entry, als volgt: (1) Als de sleutel van de old-ini-entry bestaat in de INI-bestanden, maar de sleutel van de new-ini-entry, vervangt u de oude-ini-vermelding door de nieuwe-ini-vermelding in het DOEL INI-bestand en verwijdert u vervolgens de overbodige nieuwe-ini-vermelding uit dat INI-bestand. (2) Als de sleutel van de old-ini-entry bestaat in de INI-bestanden, maar de sleutel van de new-ini-entry niet, vervangt u de oude-ini-invoersleutel door die van de nieuwe-ini-vermelding in het doel-INI-bestand, maar laat de waarde van de oude-ini-vermelding ongewijzigd. |
| 3 | Als de sleutel en waarde die voor old-ini-entry zijn opgegeven, niet kunnen worden gevonden in de INI-bestanden, doet u niets. Anders zijn de aangebrachte wijzigingen afhankelijk van overeenkomsten in de INI-bestanden voor de opgegeven sleutels en waarden van old-ini-entry en new-ini-entry, als volgt: (1) Als de sleutel=waarde van de old-ini-entry bestaat in de INI-bestanden, maar de sleutel=waarde van de new-ini-entry, vervangt u de old-ini-entry door de new-ini-entry in het doel INI-bestand en verwijdert u vervolgens de overbodige nieuwe-ini-vermelding uit dat INI-bestand . (2) Als de sleutel=waarde van de old-ini-entry bestaat in de INI-bestanden, maar de new-ini-entry niet, vervangt u de oude-ini-vermelding door de nieuwe-ini-vermelding in het doel-INI-bestand, maar laat u de waarde van de oude ini-vermelding ongewijzigd. |
Remarks
Een bepaalde update-ini-section-naam moet uniek zijn binnen het INF-bestand en moet voldoen aan de algemene regels voor het definiëren van sectienamen. Zie Algemene syntaxisregels voor INF-bestanden voor meer informatie over deze regels.
De INF biedt het volledige pad van het opgegeven ini-bestand op de distributiemedia op een van de volgende manieren:
In IHV-/OEM-opgegeven INF-bestanden, met behulp van de secties SourceDisksNames en SourceDisksFiles van dit INF om expliciet het volledige pad op te geven van elk benoemd bronbestand dat zich niet in de hoofdmap (of mappen) op de distributiemedia bevindt.
In door het systeem geleverde INF-bestanden door een of meer extra INF-bestanden op te leveren, geïdentificeerd in de vermelding LayoutFile in de sectie Versie van het INF-bestand.
Elke bestandsnaam die is opgegeven in een old-ini-entry of new-ini-entry , moet de doelmap met dat bestand aanwijzen. Een dergelijk doelmappad van een bestandsnaam in een update-ini-section-vermelding moet worden opgegeven als een dirid. Zie Diriden gebruiken voor lijsten met mogelijke diriden.