Dyrektywa INF UpdateIniFields

Caution

Począwszy od Windows 11 wersji 22H2, pakiet sterowników korzystający z tej dyrektywy nie kwalifikuje się już do podpisu z Witryny Hardware Developer Center.

Uniwersalne pakiety sterowników i sterowniki Windows nie mogą używać tej dyrektywy.

Dyrektywa UpdateIniFields odwołuje się do co najmniej jednej nazwanej sekcji, w której można określić szczegółowe modyfikacje w wierszach pliku INI.

[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]...

Każda nazwana sekcja, do którego odwołuje się dyrektywa UpdateIniFields , ma następującą postać:

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

Sekcja update-inifields może zawierać dowolną liczbę wpisów określonych przez moduł zapisywania INF, z których każda jest w osobnym wierszu.

Wpisy

ini-file
Określa nazwę pliku INI dostarczonego na nośniku źródłowym, a niejawnie nazwę pliku INI zaktualizowanego to-bena komputerze docelowym. Tę wartość można wyrazić jako nazwę pliku lub jako %strkey% token zdefiniowany w sekcji Ciągi pliku INF.

sekcja ini
Określa nazwę sekcji w ramach podanych plików INI, które zawierają wiersz do zmodyfikowania.

nazwa profilu
Określa nazwę wiersza, który ma zostać zmodyfikowany w danej sekcji INI. Aby zmodyfikować ten wiersz, należy określić co najmniej jeden z wpisów starego pola i/lub nowego pola .

stare pole
Określa istniejące pole w danym wierszu. Jeśli nowe pole zostanie pominięte w tym wpisie sekcji, to pole zostanie usunięte z danego wiersza. W przeciwnym razie dana wartość nowego pola powinna zastąpić to pole.

nowe pole
Określa zastąpienie danego starego pola lub, jeśli stare pole zostanie pominięte, dodanie do podanego wiersza.

flags
Określa (w bitzie 0) sposób interpretowania danego starego-pola i/lub nowego-pola , jeśli albo oba zawierają gwiazdkę (*), i/lub (w bitzie 1), który znak separatora ma być używany podczas dołączania danego nowego pola do danego wiersza, w następujący sposób:

Bit zero = 0
Zinterpretuj dowolną gwiazdkę (*) w określonym polu i /lub wpisach nowego pola dosłownie, a nie jako znak wieloznaczny, podczas wyszukiwania dopasowania w danym wierszu pliku INI. Jest to wartość domyślna.

Bit zero = 1
Interpretuj dowolną gwiazdkę (*) w określonym polu i /lub nowych wpisów pola jako symbol wieloznaczny podczas wyszukiwania dopasowania w danym wierszu pliku INI.

Bit jeden = 0
Użyj znaku spacji jako separatora podczas dodawania określonego wpisu nowego pola do danego wiersza pliku INI. Jest to wartość domyślna.

Bit jeden = 1
Użyj przecinka (,) jako separatora podczas dodawania określonego wpisu nowego pola do danego wiersza pliku INI.

Remarks

Dyrektywa UpdateIniFields jest prawie nigdy określona w plikach INF dla instalacji na Windows, ponieważ nie jest konieczne posiadanie plików INI na nośniku dystrybucji. Jednak dyrektywa UpdateIniFields jest prawidłowa w dowolnych sekcjach przedstawionych w instrukcji składni formalnej, a także w sekcjach zdefiniowanych przez składnik zapisywania INF, do których odwołuje się dyrektywa AddInterface lub do których odwołuje się sekcja InterfaceInstall32 .

Każda nazwa sekcji update-inifields musi być unikatowa dla pliku INF. Każda nazwa sekcji utworzonej przez moduł zapisywania INF musi być unikatowa w pliku INF i musi być zgodna z ogólnymi regułami definiowania nazw sekcji. Aby uzyskać więcej informacji na temat tych reguł, zobacz Ogólne reguły składni dla plików INF.

W przeciwieństwie do sekcji, do którego odwołuje się dyrektywa UpdateInis , sekcja, do którego odwołuje się funkcja UpdateIniFields , zastępuje, dodaje lub usuwa części wiersza w istniejącym wierszu pliku INI zamiast wpływać na całą wartość określonego wiersza. W każdym wpisie sekcji należy określić co najmniej jedną ze starych i /lub nowych wartości pól .

Wszelkie komentarze w wierszu pliku INI zmodyfikowanego to-besą usuwane, ponieważ mogą nie być stosowane po wprowadzeniu zmian zgodnie z tą sekcją. Podczas wyszukiwania pól w wierszu w plikach INI spacje, karty i przecinki są interpretowane jako ograniczniki pól. Jednak znak spacji jest używany jako separator domyślny, gdy nowe pole jest dołączane do wiersza.

InF zapewnia pełną ścieżkę danego pliku ini na nośniku dystrybucji w jeden z następujących sposobów:

  • W plikach INF dostarczanych przez IHV/OEM, używając sekcji SourceDisksNames i SourceDisksFiles tego INF, aby jawnie określić pełną ścieżkę każdego nazwanego pliku źródłowego, który nie znajduje się w katalogu głównym (lub katalogach) na nośniku dystrybucji.

  • W plikach INF dostarczanych przez system, podając co najmniej jeden dodatkowy plik INF, zidentyfikowany we wpisie LayoutFile w sekcji Wersja pliku INF.

Informacje dodatkowe

AddInterface

ClassInstall32

DDInstall

Ini2Reg

InterfaceInstall32

SourceDisksFiles

SourceDisksNames

Ciągi

UpdateInis

Wersja