Директива INF RenFiles
Внимание!
Если вы создаете универсальный пакет или пакет драйвера Windows, эта директива является недопустимой. См. статью Использование универсального INF-файла и начало работы с драйверами Windows.
Директива RenFiles ссылается на раздел, определенный inf-writer, в другом месте 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:
- Раздел add-interface, на который ссылается директива 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-файле для драйвера функции Plug and Play (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 Section.
Примеры
В этом примере показан раздел, на который ссылается директива RenFiles .
[RenameOldFilesSec]
devfile41.sav, devfile41.sys