INF UpdateIniFields ディレクティブ
注意事項
Windows 11 バージョン 22H2 以降では、このディレクティブを使用する ドライバー パッケージ は、 ハードウェア デベロッパー センターからの署名の対象ではなくなりました。
ユニバーサル ドライバー パッケージ と Windows ドライバー では、このディレクティブを使用できません。
UpdateIniFields ディレクティブは、INI ファイルの行内できめ細かな変更を指定できる 1 つ以上の名前付きセクションを参照します。
[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)
UpdateIniFields=update-inifields-section[,update-inifields-section]...
UpdateIniFields ディレクティブによって参照される各名前付きセクションの形式は次のとおりです。
[update-inifields-section]
ini-file,ini-section,profile-name[,old-field][,new-field][,flags]
...
update-inifields-section には、INF ライターによって決定されるエントリの数を、それぞれ個別の行に含めることができます。
Entries
ini-file
ソース メディアで指定された INI ファイルの名前を指定し、ターゲット コンピューター上の更新する INI ファイルの名前を暗黙的に指定します。 この値は、ファイル名または INF ファイルの Strings セクションで定義されている %strkey% トークンとして表すことができます。
ini-section
変更する行を含む特定の INI ファイル内のセクションの名前を指定します。
profile-name
指定された INI セクション内で変更する行の名前を指定します。 この行の変更を 行うには、少なくとも 1 つの 古いフィールド または 新しいフィールド のエントリを指定する必要があります。
old-field
指定された行内の既存のフィールドを指定します。 このセクションエントリから new-field を省略すると、このフィールドは指定された行から削除されます。 それ以外の場合は、指定 された 新しいフィールド 値がこのフィールドに置き換えられます。
new-field
指定した 古いフィールド の置換を指定するか、古いフィールド を省略した場合は、指定された行に追加します。
flags
次のように、指定された 新しい-フィールド を指定した行に追加するときに使用するアスタリスク (*) または (ビット 1) 区切り文字が含まれている場合に、指定された 古い-フィールド または 新しいフィールド を解釈する方法をビット 0 で指定します。
Bit zero = 0
INI ファイルの指定された行で一致するものを検索するときに、指定された 古いフィールド や 新しいフィールド のエントリのアスタリスク (*) を、ワイルド カード文字としてではなく、リテラルで解釈します。 これが既定値です。
Bit zero = 1
INI ファイルの指定された行で一致するものを検索するときに、指定された 古いフィールド や 新しいフィールド のエントリのアスタリスク (*) を、ワイルド カード文字としてではなく、リテラルで解釈します。
Bit one = 0
INI ファイルの指定された行に指定された 新しいフィールド 項目を追加する場合は、区切り文字としてスペース文字を使用します。 これが既定値です。
Bit one = 1
INI ファイルの指定された行に指定された 新しいフィールド 項目を追加する場合は、区切り文字としてコンマ(,)を使用します。
解説
UpdateIniFields ディレクティブは、配布メディアに INI ファイルを配置する必要がないため、Windows へのインストール用に INF ファイルで指定されることはほとんどありません。 ただし、UpdateIniFields ディレクティブは、正式な構文ステートメントに示されているセクションと、AddInterface ディレクティブによって参照される INF ライター定義セクション、または InterfaceInstall32 セクションで参照されているセクションで有効です。
各 update-inifields-section 名は、INF ファイルに対して一意である必要があります。 INF ライターで定義された各セクション名は、INF ファイル内で一意である必要があり、セクション名を定義するための一般的な規則に従う必要があります。 これらの規則の詳細については、「INF ファイルの一般的な構文規則」を参照してください。
UpdateInis ディレクティブによって参照されるセクションとは異なり、UpdateIniFields によって参照されるセクションは、特定の行の値全体に影響を与えるのではなく、既存の INI ファイル行の行の一部を置換、追加、または削除します。 各セクションのエントリには、 少なくとも 1 つの古いフィールド または 新しいフィールド の値を指定する必要があります。
変更する INI ファイル行のコメントは、このセクションに従って変更した後に適用できない可能性があるため、削除されます。 INI ファイルで行内のフィールドを検索すると、スペース、タブ、およびコンマがフィールド区切り文字として解釈されます。 ただし、新しいフィールドを行に追加するときに、既定の区切り記号としてスペース文字が使用されます。
INF は、次のいずれかの方法で配布メディア上の指定された ini-file の完全なパスを提供します。
IHV/OEM が提供する INF ファイルでは、この INF の SourceDisksNames セクションと、場合によっては SourceDisksFiles セクションを使用して、配布メディアのルート ディレクトリ (またはディレクトリ) にない各名前付きソース ファイルの完全なパスを明示的に指定します。
システム提供の INF ファイルでは、INF ファイルの バージョン セクションの LayoutFile エントリで識別される、1 つ以上の追加の INF ファイルを指定します。