Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Caution
Jeśli tworzysz uniwersalny lub Windows pakiet sterowników, ta dyrektywa jest nieprawidłowa. Zobacz Using a Universal INF File (Używanie uniwersalnego pliku INF) i Get started developing Windows drivers (Rozpoczynanie opracowywania sterowników Windows).
Dyrektywa RenFiles odwołuje się do sekcji zdefiniowanej przez składnik zapisywania INF w innym miejscu w pliku INF, co powoduje, że lista plików, które mają być zmieniane w kontekście operacji w sekcji, w której określono odwołującą się dyrektywę RenFiles .
[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)
Renfiles=file-list-section[,file-list-section]...
Dyrektywę RenFiles można określić w dowolnej sekcji pokazanej w instrukcji składni formalnej. Tę dyrektywę można również określić w dowolnej z następujących sekcji zdefiniowanych przez moduł zapisywania INF:
- Sekcja add-interface-referenced by the AddInterface dyrektywy w DDInstall. Sekcja Interfejsy.
- Sekcja install-interface-reference w sekcji InterfaceInstall32.
Każda nazwana sekcja, do której odwołuje się dyrektywa RenFiles , ma co najmniej jeden wpis następującego formularza:
[file-list-section]
new-dest-file-name,old-source-file-name
...
Sekcja lista-plików może zawierać dowolną liczbę wpisów, z których każda znajduje się w osobnym wierszu.
Wpisy
new-dest-file-name
Określa nową nazwę, która ma zostać nadana plikowi w miejscu docelowym.
old-source-file-name
Określa starą nazwę pliku.
Remarks
Important
Niniejsza dyrektywa musi być starannie używana. Zdecydowanie zalecamy, aby nie używać dyrektywy RenFiles w pliku INF dla sterownika funkcji Plug and Play (PnP).
Dowolna nazwa sekcji listy plików musi być unikatowa dla pliku INF, ale może być przywołyna przez dyrektywy CopyFiles, DelFiles lub RenFiles w innym miejscu w tej samej innej lokalizacji INF. Taka nazwa sekcji zdefiniowanej przez moduł zapisywania INF 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.
Dyrektywa RenFiles nie obsługuje dekorowania nazwy sekcji file-list-section z rozszerzeniem platformy zdefiniowanej przez system (.nt, ntx86, . ntia64, .ntamd64, .ntarm lub .ntarm64).
Sekcja DestinationDirs pliku INF kontroluje miejsce docelowe wszystkich operacji zmiany nazwy plików, niezależnie od sekcji zawierającej konkretną dyrektywę RenFiles . Następujące reguły opisują operację zmiany nazwy pliku:
Jeśli nazwana sekcja, do którego odwołuje się dyrektywa RenFiles , ma odpowiedni wpis w sekcji DestinationDirs w tej samej inf, ten wpis jawnie określa docelowy katalog docelowy. Wszystkie pliki wymienione w nazwanej sekcji zostaną zmienione na miejscu docelowym przed skopiowanie tych plików źródłowych.
Jeśli nazwana sekcja nie znajduje się na liście w sekcji DestinationDirs, Windows używa wpisu DefaultDestDir w sekcji DestinationDirs in the INF.
Uwaga
Do określenia nowych lub starych nazw plików nie można użyć tokenu %strkey%. Aby uzyskać więcej informacji na temat tokenów% strkey %, zobacz sekcję Ciągi INF.
Examples
W tym przykładzie przedstawiono sekcję przywołyną przez dyrektywę RenFiles .
[RenameOldFilesSec]
devfile41.sav, devfile41.sys