INF Ini2Reg ディレクティブ
注意事項
Windows 11 バージョン 22H2 以降では、このディレクティブを使用する ドライバー パッケージ は、 ハードウェア デベロッパー センターからの署名の対象ではなくなりました。
ユニバーサル ドライバー パッケージ と Windows ドライバー では、このディレクティブを使用できません。
Ini2Reg ディレクティブは、指定された INI ファイルの行またはセクションがレジストリに移動される 1 つ以上の名前付きセクションを参照します。 これにより、指定したキーの下に 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)
Ini2Reg=ini-to-registry-section[,ini-to-registry-section]...
Ini2Reg ディレクティブによって参照される各名前付きセクションの形式は次のとおりです。
[ini-to-registry-section]
ini-file,ini-section,[ini-key],reg-root,subkey[,flags]
...
ini-to-registry-section には、INF ライターによって決定されるエントリの数を、それぞれ個別の行に含めることができます。
Entries
ini-file
ソース メディアで指定された INI ファイルの名前を指定します。 この値は、ファイル名または INF ファイルの Strings セクションで定義されている %strkey% トークンとして表すことができます。
ini-section
コピーするレジストリ情報を含む、指定された INI ファイル内のセクションの名前を指定します。
ini-key
レジストリにコピーする INI ファイル内のキーの名前を指定します。 この値を省略すると、 ini セクション 全体が指定されたレジストリ サブキーに転送されます。
reg-root
このエントリで指定された他の値のレジストリ ツリーのルートを識別します。 詳細については、 AddReg ディレクティブのリファレンスを参照してください。
subkey
値を受け取るサブキーを識別します。これは、INF の Strings セクションで定義された %strkey% トークンとして、または指定された reg-rootからの明示的なレジストリ パス(key1\key2\key3...)として表現されます。
flags
指定された情報をレジストリに転送した後に INI ファイルを処理する方法を (ビット 0 で) 指定し、既存のレジストリ情報を上書きするかどうかを (ビット 1 で) 次のように指定します。
Bit zero = 0
レジストリにコピーした後、INI ファイルから指定された情報を削除しないでください。 これが既定です。
Bit zero = 1
レジストリに移動した後、INI ファイルから指定された情報を削除します。
Bit one = 0
指定したサブキーがレジストリに既に存在する場合は、INI が指定した情報をこの サブキーに転送しないでください。 それ以外の場合は、この INI 指定の情報を値エントリとして使用して、レジストリに指定された サブキー を作成します。 これが既定です。
Bit one = 1
指定したサブキーがレジストリに既に存在する場合は、その値エントリを INI 指定の情報に置き換えます。
解説
Ini2Reg ディレクティブは、正式な構文ステートメントに示されているセクションのいずれかで有効です。 このディレクティブは、 AddInterface ディレクティブによって参照される、または InterfaceInstall32 セクションで参照される INF ライター定義セクションでも有効です。
INF ファイルを使用して Windows XP 以降のバージョンの Windows にデバイスをインストールする場合、INF ファイルには Ini2Reg ディレクティブを含めてはなりません。 Ini2Reg ディレクティブを含む INF ファイルは、 "Windows 向けに設計された" ロゴ テストに合格せず、デジタル署名を受け取らないので、Windows によって信頼されません (「Windows でドライバーを選択する方法」を参照)。
各 ini-to-registry セクション 名は、INF ファイルに対して一意である必要があります。 INF ライターで定義された各セクション名は、INF ファイル内で一意である必要があり、セクション名を定義するための一般的な規則に従う必要があります。 これらの規則の詳細については、「INF ファイルの一般的な構文規則」を参照してください。
INF は、次のいずれかの方法で配布メディア上の指定された ini-file の完全なパスを提供します。
IHV/OEM が提供する INF ファイルでは、この INF の SourceDisksNames セクションと、場合によっては SourceDisksFiles セクションを使用して、配布メディアのルート ディレクトリ (またはディレクトリ) にない各名前付きソース ファイルの完全なパスを明示的に指定します。
システム提供の INF ファイルでは、INF ファイルの バージョン セクションの LayoutFile エントリで識別される、1 つ以上の追加の INF ファイルを指定します。