AddReg 指令引用一個或多個 INF 寫入者定義的 _add-登錄區段*,用於修改或建立登錄檔資訊。
[DDInstall] |
[DDInstall.HW] |
[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)
[install-interface-section] |
[service-install-section] |
[event-log-install] |
[add-interface-section]
AddReg=add-registry-section[,add-registry-section] ...
每個 新增登錄區段 可以有以下項目:
新增鍵鑰,可能帶有初始值條目,加入登錄檔。
在現有登錄檔鍵中新增值項目。
修改登錄檔中特定鍵的現有值項目。
每個由 AddReg 指令引用的名稱新增登錄區段格式如下:
[add-registry-section]
reg-root,[subkey],[value-entry-name],[flags],[value][,[value]]
reg-root,[subkey],[value-entry-name],[flags],[value][,[value]]
...
[[add-registry-section.security]
"security-descriptor-string"]
新增登錄區段可以有任意數量的條目,每個條目都位於獨立的行。 INF 也可以包含一個或多個可選的 add-registry-section.security 區段,每個區段指定一個安全描述符,該描述符套用於該命名的 add-registry-區段內描述的所有登錄檔值。
Entries
規則根
識別本條目中其他值登錄樹的根節點。 此值可以是下列其中一項:
香港鐵路
HKEY_CLASSES_ROOT縮寫
香港 CU
HKEY_CURRENT_USER 的縮寫
香港電影學院
HKEY_LOCAL_MACHINE 的縮寫
香港大學
HKEY_USERS 的縮寫
HKR
相對根,其中使用此縮寫指定的鍵是相對於該 AddReg 指令出現的 INF 區段所對應的登錄檔鍵,如下表所示。
| 包含 AddReg 指令的 INF 章節 | HKR 參考的登錄金鑰 |
|---|---|
| 步兵 DDInstall 分隊 | 裝置 的軟體金鑰 |
| INF DDInstall。硬體 部門 | 裝置的 硬體金鑰 |
| INF( 服務安裝區段) 區段 | 服務金鑰 |
| INF [事件日誌安裝] 區塊 | EventLog 金鑰 |
| INF [add-interface-section] 區段 | 裝置介面的登錄檔金鑰 |
注意
HKR 無法用於從 INF DefaultInstall 區段引用的新增登錄區段。
欲了解更多關於儲存在 HKEY_LOCAL_MACHINE 根節點下的驅動程式資訊,請參閱裝置 與驅動程式的登錄組樹與金鑰。
子機碼
此可選值可作為 %strkey% token 定義於 INF 的 字 串區段,或在指定 註冊根 (key1\key2\key3...)下的登錄路徑形成,指定以下其中之一:
- 在指定登錄路徑的末端新增一個子金鑰。
- 一個已存在的子鍵,將此項中指定的額外值寫入其中(可能替換該子鍵中已存在的命名值條目)。
- 同時新增一個子鍵,連同初始值條目一起加入登錄檔。
value-entry-name
這個可選值要麼命名給定(現有) 子鍵 中的一個現有值項目,要麼建立一個新的值項目名稱,無論該子 鍵已存在或是新加入登錄檔的鍵。 這個值可以表示為「引號字串」,或是 INF 字串部分中定義的 %strkey% token。 (若字串型值省略此項, 則 value-entry-name 是該鍵的預設「未命名」值項。)
作業系統支援一些系統定義的特殊 值-項目-名稱 關鍵字。 更多資訊請參閱本 評論 區末尾。
flags
此可選的十六進位值,以系統定義的低字與高字旗標值的 OR 位元遮罩表示,定義值項的資料型態及/或控制加法登錄操作。
這些旗標的位元遮罩值如下:
0x00000001 (FLG_ADDREG_BINVALUETYPE)
給定的數值是「原始」資料。 (此值與FLG_ADDREG_TYPE_BINARY相同。)
0x00000002 (FLG_ADDREG_NOCLOBBER)
防止某個特定值取代現有的值項。
0x00000004 (FLG_ADDREG_DELVAL)
從登錄檔中刪除給定子鍵,或從指定的登錄檔子鍵中刪除指定的值-entry-name。
0x00000008 (FLG_ADDREG_APPEND)
將指定 值 附加到現有命名值的項目上。 此旗標僅在 FLG_ADDREG_TYPE_MULTI_SZ 同時設定時有效。 若指定的字串值已存在,則不予附加。
0x00000010 (FLG_ADDREG_KEYONLY)
建立給定 的子鍵,但忽略任何提供的值-入口名稱和/或值。
0x00000020 (FLG_ADDREG_OVERWRITEONLY)
只有當指定的值-entry-name已存在於給定子鍵中時,才會重設為所提供的值。
0x00001000 (FLG_ADDREG_64BITKEY)
(Windows XP 及後續版本的 Windows。)在 64 位元登錄檔中進行指定的變更。 若未指定,則會變更至原生登錄檔。
0x00002000 (FLG_ADDREG_KEYONLY_COMMON)
(Windows XP 及後續版本的 Windows。)這和FLG_ADDREG_KEYONLY相同,但也適用於 INF DelReg 指令的 del-registry-section。
0x00004000 (FLG_ADDREG_32BITKEY)
(Windows XP 及後續版本的 Windows。)在 32 位元登錄檔中進行指定的變更。 若未指定,則會變更至原生登錄檔。
0x00000000 (FLG_ADDREG_TYPE_SZ)
給定的值條目和/或值屬於類型 REG_SZ。
注意
此值是指定值項目的預設類型,因此在 add-registry-區段中,只要操作此類值項,則可省略任何 reg-root= 行。
0x00010000 (FLG_ADDREG_TYPE_MULTI_SZ)
給定的值項和/或值屬於登錄型別 REG_MULTI_SZ。 接下來的值欄位可以是一串以逗號分隔的字串。 此規範不要求給定字串值使用任何 NULL 終止子。
0x00020000 (FLG_ADDREG_TYPE_EXPAND_SZ)
給定的 值-entry-name 和/或 值 屬於登錄型別 REG_EXPAND_SZ。
0x00010001 (FLG_ADDREG_TYPE_DWORD)
給定的 值-entry-name 和/或 值 屬於登錄檔類型 REG_DWORD。
0x00020001 (FLG_ADDREG_TYPE_NONE)
給定 的值-entry-name 和/或 值 屬於登錄檔類型 REG_NONE。
0x000B0001 (FLG_ADDREG_TYPE_QWORD)
給定的 值-entry-name 和/或 值 屬於登錄檔類型 REG_QWORD。
value
此功能可選擇指定新增的 值-entry-name ,加入給定的登錄鍵。 此類值可以是現有鍵中已命名值條目的「替換」值,或是要附加於現有鍵中命名REG_MULTI_SZ型值項的值(旗標值 0x00010008)、寫入現有鍵的新值條目,或是新增子鍵的初始值條目。
此 值 的表達方式取決於旗 標指定的登錄檔類型,具體如下:
登錄檔字串類型的值可以表示為「引號字串」或在 INF 檔案的字串區段定義的 %strkey% token 形式。 這種 INF 指定的值不必在每個字串末尾包含 NULL 終止符。
登錄號碼的數值可以用十六進位(使用0x符號)或十進位表示。
安全描述符字串
指定一個安全描述符,適用於所有由指定 新增登錄區段建立的登錄檔項目。
安全描述符字串是帶有標記的字串,用以表示 DACL (D:) 安全元件。
若未指定 add-registry-section.security 區段,登錄檔條目會繼承父金鑰的安全設定。
若指定 add-registry-section.security 區段,必須包含以下 ACE,以便安裝與升級裝置及系統服務包:
- (A;;GA;;;SY) − 授予所有存取本地系統的權限。
- (A;;GA;;;BA) − 授權所有內建管理員存取權限。
不要指定授權非特權使用者寫入權限的 ACE 字串。
有關安全描述符字串的資訊,請參見安全描述符定義語言(Windows)。 關於安全描述符字串格式的資訊,請參見安全描述符定義語言(Windows)。
欲了解更多如何指定安全描述符的資訊,請參閱 建立安全裝置安裝。
Remarks
AddReg 指令可以在上述正式語法陳述中的任何一個章節中指定。 此指令亦可依下列 INF 撰寫者定義的區段指定:
INF DDInstall 中由 AddService 指令參考的服務-安裝區段或事件-日誌-安裝區段。服務區。
一個由 INF DDInstall 中 AddInterface 指令所參考的 add-interface-section。介面區。
一個安裝 介面區段 ,在 INF InterfaceInstall32 區塊中被引用。
每個 新增登錄區段 名稱必須對 INF 檔案獨一無二,但同一 INF 的其他區段中可透過 AddReg 指令引用。 每個區名必須遵循 INF 檔案一般語法規則中定義區名的一般規則。
注意
旗標值中低字的低階位元用來區分字元與二進位資料。
若要表示非預定義的 REG_XXX 類型之外的註冊表類型編號,請在旗 標 的高字中指定一個新的類型號碼,並以 FLG_ADDREG_BINVALUETYPE 在低字。
此類 值 的資料必須以二進位格式指定為一串以逗號分隔的位元組序列。 例如,若要儲存16位元組的新登錄資料類型資料,例如0x38,作為值條目,新增登錄區段條目會是如下:
HKR,,MYValue,0x00380001,1,0,2,3,4,5,6,7,8,9,A,B,C,D,E,F
此技術可用於定義數值的新登錄型別,但無法用於類型 REG_EXPAND_SZ、 REG_MULTI_SZ、 REG_NONE 或 REG_SZ 的值。 欲了解更多此類類型資訊,請參閱 登錄檔值類型。
特殊的 值-入口-名稱 關鍵字
HKR AddReg 條目中會定義特殊關鍵字。 使用這些關鍵字的條目格式如下:
[HKR,,DeviceCharacteristics,0x10001,characteristics]
[HKR,,DeviceType,0x10001,device-type]
[HKR,,Security,,security-descriptor-string]
[HKR,,UpperFilters,0x10000,service-name]
[HKR,,LowerFilters,0x10000,service-name]
[HKR,,Exclusive,0x10001,exclusive-device]
[HKR,,EnumPropPages32,,"prop-provider.dll,provider-entry-point"]
[HKR,,LocationInformationOverride,,"text-string"]
[HKR,,ResourcePickerTags,,"text-string"]
[HKR,,ResourcePickerExceptions,,"text-string"] ,
以下描述使用這些特殊關鍵字的HKR AddReg 條目:
裝置特性
DeviceCharacteristics HKR AddReg 條目會指定該裝置的特性。
特徵值是數值,是對一個或多個 FILE_* 檔案特性值使用或(OR)後產生的,這些值在 Wdm.h 和 Ntddk.h 中都有定義。
INF 中只能指定以下數值:
#define FILE_REMOVABLE_MEDIA 0x00000001
#define FILE_READ_ONLY_DEVICE 0x00000002
#define FILE_FLOPPY_DISKETTE 0x00000004
#define FILE_WRITE_ONCE_MEDIA 0x00000008
#define FILE_DEVICE_SECURE_OPEN 0x00000100
關於這些值的說明,請參見 IoCreateDevice。
這些特徵值是透過 DeviceCharacteristics 條目指定,並與每次呼叫 IoCreateDevice 時指定的值進行 OR化,該呼叫在裝置堆疊上建立裝置物件。 OR 操作發生在所有裝置物件加入後,但裝置尚未啟動之前。
特性值(包括零值)會覆蓋所有在相關類別安裝程式 INF 中指定的全類別裝置特性。
欲了解更多裝置特性資訊,請參閱 「指定裝置特性」。
裝置類型
DeviceType HKR AddReg 條目指定該裝置的裝置類型。 裝置類型是 Wdm.h 或 Ntddk.h 中定義的 FILE_DEVICE_XXX 常數的數值。 0x10001 的旗標值指定裝置型態值為 REG_DWORD。 欲了解更多資訊,請參閱 「指定裝置類型」。
類別安裝程式的 INF 應指定適用於類別中所有或幾乎所有裝置的裝置類型。 例如,若類別中的裝置屬於類型 FILE_DEVICE_CD_ROM,則指定一個 裝置類型的 0x02。 如果裝置 INF 指定了 DeviceType 的值,它會覆寫類別安裝者設定的值(如果有的話)。 若類別或裝置 INF 指定 DeviceType 值,PnP 管理器會將該類型套用到由裝置匯流排驅動程式建立的 實體裝置物件(PDO )。
Security
Security HKR AddReg 條目指定裝置的安全描述符。
安全描述符字串是帶有標記的字串,用以表示 DACL (D:) 安全元件。
類別安裝程式 INF 可以指定裝置類別的安全描述符。 裝置 INF 可以為單一裝置指定安全描述符,覆蓋該類別的安全。 若類別及/或裝置 INF 指定安全描述符字串,PnP 管理器會將描述符傳播至該裝置的所有裝置物件(DO)。 這包括功能裝置物件(FDO)、可選的 濾波 DO 以及 PDO。
有關安全描述符字串格式的資訊,請參閱 Microsoft Windows SDK 文件。
欲了解更多如何指定安全描述符的資訊,請參閱 建立安全裝置安裝。
上過濾器
UpperFilters HKR AddReg 條目指定了一個 PnP 上濾波器驅動程式。 這是 在 DDIns 的一篇文章。硬體 部分定義了一個或多個裝置專屬的上濾波器驅動程式。 在 ClassInstall32 章節中,此條目定義了一個或多個全類別的上濾波器驅動程式。
下濾波器
LowerFilters HKR AddReg 條目指定了 PnP 下濾波器驅動程式。 這是在 DDIns 的一篇文章。硬體部分定義了一個或多個裝置專屬的下濾波器驅動程式。 在 ClassInstall32 的一個章節中,這個條目定義了一個或多個全類別的下濾波器驅動程式。
獨佔
如果存在且設為「1」的 Exclusive HKR AddReg 條目,則指定該裝置為 獨佔裝置。 否則該裝置不被視為排他性。 欲了解更多資訊,請參閱 「指定對裝置物件的專屬存取」。
EnumProp第32頁
EnumPropPages32 HKR AddReg 條目指定一個動態連結函式庫(DLL)檔案的名稱,該檔案是裝置特定的屬性頁提供者。 它也指定了 ExtensionPropSheetPageProc 回調函式的名稱,該函式由 DLL 實作。 欲了解更多關於屬性頁面與函式的資訊,請參閱 Microsoft Windows 軟體開發套件(SDK)Windows 7 及 .NET Framework 4.0。
Important
DLL 名稱與 ExtensionPropSheetPageProc 回調函式都必須以引號(「 “)包圍在一起」。
地點資訊覆蓋
(Windows XP 及更新版本的 Windows)LocationInformationOverride HKR AddReg 條目可用來指定描述裝置物理位置的文字字串。 它會覆蓋裝置匯流排驅動程式在回應IRP_MN_QUERY_DEVICE_TEXT請求時所提供的 LocationInformation 字串。
ResourcePickerTags
ResourcePickerTags HKR AddReg 條目指定裝置的資源選擇標籤。
ResourcePickerExceptions
ResourcePickerExceptions HKR AddReg 條目會指定裝置允許的資源衝突。
Examples
AddReg 指令在此範例中引用了 (SCSI) Miniport_EventLog_AddReg 區段,該區段由 INF-writer 定義,該區段由 DDInstall 中的 AddService 指令所參考。這個INF的服務部門。
[Miniport_EventLog_AddReg]
HKR,,EventMessageFile,0x00020000,"%%SystemRoot%%\System32\IoLogMsg.dll"
; double quotation marks delimiters in preceding entry prevent truncation
; if line wraps
HKR,,TypesSupported,0x00010001,7
請注意,你可以選擇以十六進位格式指定旗標值,如範例所示,或是定義字串佔位符,例如 %FLG_ADDREG_TYPE_DWORD% 每個 INF 檔案的 [Strings] 區段。