INF RenFiles 指示詞
警告
如果您要建置通用或 Windows 驅動程式套件,這個指示詞無效。 請參閱搭配 Windows 驅動程式使用通用 INF 檔案和 使用者入門。
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 寫入器定義的區段內指定這個指示詞:
- DDInstall 中 AddInterface 指示詞所參考的 add-interface-section。介面區段。
- InterfaceInstall32 區段中參考的 install-interface-section。
RenFiles 指示詞所參考的每個具名區段都有一或多個下列格式的專案:
[file-list-section]
new-dest-file-name,old-source-file-name
...
file-list-section 可以有任意數目的專案,每個專案都位於個別行上。
項目
new-dest-file-name
指定要在目的地上提供給檔案的新名稱。
old-source-file-name
指定檔案的舊名稱。
備註
重要
這個指示詞必須謹慎使用。 強烈建議您不要將 INF 檔案中的 RenFiles 指示詞用於 隨插即用 (PnP) 函式驅動程式。
任何 file-list-section 名稱都必須對 INF 檔案是唯一的,但可由 CopyFiles、 DelFiles 或 RenFiles 指示詞參考相同的 INF 中其他位置。 這類 INF 寫入器定義的區段名稱必須遵循定義區段名稱的一般規則。 如需這些規則的詳細資訊,請參閱 INF 檔案的一般語法規則。
RenFiles 指示詞不支援以系統定義的平臺擴展名裝飾檔案清單區段名稱, (.nt、.ntx86、.ntia64、.ntamd64、.ntarm 或 .ntarm64) 。
INF 檔案的 DestinationDirs 區段會控制所有檔案重新命名作業的目的地,而不論包含特定 RenFiles 指示詞的 區段為何。 下列規則描述檔案重新命名作業:
如果 RenFiles 指示詞所參考的具名區段在相同 INF 的 DestinationDirs 區段中有對應的專案,該專案會明確指定目標目的地目錄。 在複製這些來源檔案之前,所有列在具名區段中的檔案都會重新命名在目的地上。
如果未在 DestinationDirs 區段中列出具名區段,Windows 會在 INF 的 DestinationDirs 區段中使用 DefaultDestDir 專案。
注意
您無法使用 %strkey% 令牌來指定新的或舊的檔案名。 如需 %strkey% Token 的詳細資訊,請參閱 INF 字串一節。
範例
此範例顯示 RenFiles 指示詞所參考的區段。
[RenameOldFilesSec]
devfile41.sav, devfile41.sys