INF Ini2Reg 指示詞

發行項
02/02/2024

警告

從 Windows 11 22H2 版開始，使用此指示詞的驅動程式套件不再符合硬體開發人員中心的簽章資格。

Ini2Reg 指示詞會參考一或多個具名區段，其中提供的 INI 檔案中的行或區段會移至登錄中。這會在指定的索引鍵下建立或取代一或多個值專案。

[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 寫入器決定的項目數目，每一行各有一個。

項目

ini-file
指定來源媒體上提供的 INI 檔名。此值可以表示為檔名，或以 INF 檔案之 Strings 區段中定義的 %strkey% 令牌表示。

ini-section
指定指定 INI 檔案內包含要複製之登錄資訊的區段名稱。

ini-key
指定要複製到登錄之 INI 檔案中的機碼名稱。如果省略此值，則會將整個 ini 區段 傳輸至指定的登錄 子機碼。

reg-root
識別此專案中提供之其他值的登錄樹狀結構根目錄。如需詳細資訊，請參閱 AddReg 指示詞的參考。

子機碼
識別要接收值的子機碼，以 INF 的 Strings 區段中定義的 %strkey% 令牌表示，或以明確登錄路徑表示， (key1\key2\key3...) 指定的 reg-root。

flags
指定位 0 中的 (，) 如何將指定的資訊傳送至登錄和/或位 1 中的 (處理 INI 檔案，) 是否要覆寫現有的登錄資訊，如下所示：

位零 = 0
將它複製到登錄之後，請勿從 INI 檔案中移除指定的資訊。此為預設值。

位零 = 1
將它移至登錄之後，請從 INI 檔案中刪除指定的資訊。

位 1 = 0
如果指定的子機碼已存在於登錄中，請勿將 INI 提供的資訊傳送到這個 子機碼。否則，請在登錄中建立指定的 子機碼 ，並使用此 INI 提供的資訊作為其值專案。此為預設值。

位一 = 1
如果登錄中已經有指定的子機碼，請使用 INI 提供的資訊取代其值專案。

備註

Ini2Reg 指示詞在正式語法語句所示的任何區段中都是有效的。這個指示詞也適用於 AddInterface 指示詞所參考的 INF 寫入器定義區段，或在 InterfaceInstall32 區段中參考。

如果使用 INF 檔案在 Windows XP 和更新版本的 Windows 上安裝裝置，INF 檔案不應包含 Ini2Reg 指示詞。包含 Ini2Reg 指示詞的 INF 檔案不會通過「專為 Windows 設計」標誌測試，將不會收到數位簽名，因此 Windows (請參閱 Windows 選取驅動程式) 的方式。

每個 ini-to-registry-section 名稱都必須是唯一的 INF 檔案。每個 INF 寫入器建立的區段名稱在 INF 檔案內必須是唯一的，而且必須遵循定義區段名稱的一般規則。如需這些規則的詳細資訊，請參閱 INF 檔案的一般語法規則。

INF 會以下列其中一種方式，在散發媒體上提供指定 ini-file 的完整路徑：

在 IHV/OEM 提供的 INF 檔案中，使用 SourceDisksNames 和此 INF 的 SourceDisksFiles 區段，明確指定不在根目錄 (或發佈媒體上) 的每個具名來源檔案的完整路徑。
在系統提供的 INF 檔案中，藉由提供一或多個額外的 INF 檔案，在 INF 檔案的 Version 區段中的 LayoutFile 項目中識別。