Директива INF RenFiles
Внимание
Если вы создаете универсальный или пакет драйвера Windows, эта директива недопустима. Ознакомьтесь с использованием универсального INF-файла и начала разработки драйверов Windows.
Директива RenFiles ссылается на раздел INF-записи в другом месте INF-файла, что приводит к переименованию списка файлов в контексте операций с разделом, в котором указана директива 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]...
Директива RenFiles может быть указана в любом из разделов, показанных в формальной инструкции синтаксиса. Эта директива также может быть указана в любом из следующих разделов INF-writer:
- Раздел надстройки, на который ссылается директива AddInterface в DDInstall. Раздел интерфейсов.
- Раздел install-interface, на который ссылается раздел InterfaceInstall32.
Каждый именованный раздел, на который ссылается директива RenFiles , содержит одну или несколько записей следующей формы:
[file-list-section]
new-dest-file-name,old-source-file-name
...
В разделе списка файлов может быть любое количество записей, каждое из которых содержит отдельную строку.
Операции
new-dest-file-name
Указывает новое имя, которое будет присвоено файлу в назначении.
old-source-file-name
Указывает старое имя файла.
Замечания
Внимание
Эту директиву следует тщательно использовать. Настоятельно рекомендуется не использовать директиву RenFiles в INF-файле для драйвера функции самонастраивающийся (PnP).
Любое имя раздела списка файлов должно быть уникальным для INF-файла, но на него можно ссылаться директивы CopyFiles, DelFiles или RenFiles в другом месте в том же INF. Такое имя раздела INF-writer должно соответствовать общим правилам определения имен разделов. Дополнительные сведения об этих правилах см. в разделе Общие правила синтаксиса для INF-файлов.
Директива RenFiles не поддерживает украшение имени раздела файла с расширением платформы, определяемым системой (.nt, ntx86, .ntia64, .ntamd64, .ntarm или NTARM64).
Раздел DestinationDirs в INF-файле управляет назначением для всех операций переименования файлов независимо от раздела, содержащего определенную директиву RenFiles . В следующих правилах описана операция переименования файла:
Если именованный раздел, на который ссылается директива RenFiles, имеет соответствующую запись в разделе DestinationDirs в том же INF, то эта запись явно указывает целевой целевой каталог назначения. Все файлы, перечисленные в именованном разделе, переименованы в назначение перед копированием этих исходных файлов.
Если именованный раздел не указан в разделе DestinationDirs , Windows использует запись DefaultDestDir в разделе DestinationDirs INF.
Примечание.
Маркер %strkey% нельзя использовать для указания новых или старых имен файлов. Дополнительные сведения о маркерах %strkey% см. в разделе INF Strings.
Примеры
В этом примере показан раздел, на который ссылается директива RenFiles .
[RenameOldFilesSec]
devfile41.sav, devfile41.sys