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 ライター定義セクション内のいずれかで指定することもできます。
- DDInstall.Interfaces セクションの AddInterface ディレクティブで参照される add-interface-section です。
- InterfaceInstall32 セクションで参照される install-interface-section。
RenFiles ディレクティブによって参照される各名前付きセクションには、次の形式の 1 つ以上のエントリがあります。
[file-list-section]
new-dest-file-name,old-source-file-name
...
ファイル リスト セクション には、それぞれ個別の行に任意の数のエントリを含めることができます。
Entries
new-dest-file-name
コピー先のファイルに指定する新しい名前を指定します。
old-source-file-name
ファイルの旧名を指定します。
解説
重要
このディレクティブは慎重に使用する必要があります。 プラグ アンド プレイ (PnP) 関数ドライバーの INF ファイルで RenFiles ディレクティブを使用しないことを強くお勧めします。
すべての ファイル リスト セクション 名は INF ファイルに対して一意である必要がありますが、同じ INF ファイル内の他の場所にある CopyFiles、 DelFiles、または RenFiles ディレクティブで参照できます。 このような INF ライター定義セクション名は、セクション名を定義するための一般的な規則に従う必要があります。 これらの規則の詳細については、「INF ファイルの一般的な構文規則」を参照してください。
RenFiles ディレクティブは、システム定義のプラットフォーム拡張子 (.nt、 .ntx86、 .ntia64、 .ntamd64、 .ntarm、または .ntarm64) を使用した ファイル リスト セクション 名の修飾をサポートしていません。
INF ファイルの DestinationDirs セクションは、特定の RenFiles ディレクティブを含むセクションに関係なく、すべてのファイル名変更操作の宛先を制御します。 次の規則では、ファイル名の変更操作について説明します。
RenFiles ディレクティブによって参照される名前付きセクションに、同じ INF の DestinationDirs セクションに対応するエントリがある場合、そのエントリはターゲットの宛先ディレクトリを明示的に指定します。 名前付きセクションにリストされているすべてのファイルは、これらのソース ファイルがコピーされる前に、コピー先で名前が変更されます。
名前付きセクションが DestinationDirs セクションに表示されていない場合、Windows は INFの DestinationDirs セクションの DefaultDestDir エントリを使用します。
Note
%strkey% トークンを使用して新しいファイル名または古いファイル名を指定することはできません。 %strkey% トークンの詳細については、「INF 文字列」セクションを参照してください。
例
この例では、RenFiles ディレクティブによって 参照されるセクションを 示します。
[RenameOldFilesSec]
devfile41.sav, devfile41.sys