步兵DDInstall.HW部門

DDInstall。硬體 區段通常用於安裝多功能裝置、安裝 PnP 濾波器驅動程式,以及在登錄檔中設定任何使用者可存取的裝置專屬但與驅動程式無關的資訊,無論是包含 AddReg 指令, 或是包含 與 需求 條目。

[install-section-name.HW] |
[install-section-name.nt.HW] |
[install-section-name.ntx86.HW] |
[install-section-name.ntia64.HW] | (Windows XP and later versions of Windows)
[install-section-name.ntamd64.HW] | (Windows XP and later versions of Windows)
[install-section-name.ntarm.HW] | (Windows 8 and later versions of Windows)
[install-section-name.ntarm64.HW] (Windows 10 version 1709 and later versions of Windows)
 
[AddReg=add-registry-section[,add-registry-section]...] ...
[Include=filename.inf[,filename2.inf]...]
[Needs=inf-section-name[,inf-section-name]...]
[DelReg=del-registry-section[,del-registry-section]...] ...
[BitReg=bit-registry-section[,bit-registry-section] ...] 

Entries

並非所有有效條目都支援 通用 INF。 以下列出了哪些指令在普遍 INF 中有效,哪些無效。

支援於通用中程彈

AddReg=add-registry-section[,add-registry-section]...
參考 INF 檔案中一個或多個由 INF 撰寫者定義的 附加登錄區段 ,針對本 DDInstall 涵蓋的裝置。作業 區。 新增登錄表區塊通常會安裝過濾器和/或將每個裝置的資訊儲存在登錄檔中。 HKR 規範在此類新增登錄區中指定裝置的硬體金鑰,即包含裝置資訊的裝置專屬登錄子金鑰。 硬體金鑰也稱為裝置金鑰。 欲了解更多資訊,請參閱 裝置與驅動程式的登錄樹與金鑰。 驅動程式套件可透過 INF 加入 HKR 規範,在 add-registry-section 中加入 DDInstall.HW 區段來新增設定。

欲了解更多資訊,請參閱 INF AddReg 指令。

Include=檔名。inf[,檔案名稱2.inf]...
指定一個或多個系統提供的額外 INF 檔案,包含安裝此裝置所需的區段。 如果此條目有指定,通常也會標示 為需求 條目。

需求=inf-section-name[,inf-section-name]...
規定安裝此裝置時必須處理的指定區段。 通常,這類命名區段稱為 DDInstall。系統提供的 INF 檔案中,包含在 Include 條目中的 HW 區段。 然而,它可以是此類 DDInstall 中被引用的任何區段。包含步兵的重裝 部隊。

通用 INF 不支援

DelReg=del-registry-section[,del-registry-section]...
參考 INF 檔案中一個或多個由 INF 撰寫者定義的 刪除登錄區段,針對本 DDInstall 區段涵蓋的裝置驅動程式。 此類刪除登錄區會從目標電腦移除先前安裝的裝置/驅動程式的過時登錄資訊。 HKR 規範中刪除登錄區塊指定的子金鑰與 AddReg 相同。

此指令很少使用,除非在 INF 檔案中升級先前安裝的相同裝置/型號,該模組定義了該 DDInstall 區塊名稱的「每個製造商每個型號」章節。 欲了解更多資訊,請參閱 INF外邦政府指令。

BitReg=位元登錄區[,位元註冊區] ...
在本節中有效,但幾乎不使用。 HKR 規範在參考的位元登錄區段中指定與 AddReg 相同的子金鑰。 欲了解更多資訊,請參閱 INF BitReg 指令。

Remarks

正式語法陳述中顯示的 安裝區段名稱 不區分大小寫的擴展,可以插入此類 DDInstall。跨平台 INF 檔案中的硬體 區段名稱。 欲了解更多如何使用系統定義的 .nt、 .ntx86、 .ntia64、 .ntamd64、 .ntarm 及 .ntarm64 擴充名的資訊,請參閱「 為多平台與作業系統建立 INF 檔案」。

任何 DDInstall。作業 區必須具備以下其中一項:

  • 一個 AddReg 指令。
  • 一個包含( Include )條目,指定另一個 INF 檔案。 在這裡,就是 DDInstall。HW 區塊也必須包含對應 的需求 條目,指定另一個 INF 檔案中的某個區段。 本節用於建立必要的登記資訊。

每個指令都在 DDInstall。硬體 區段可以參考多個由 INF 寫入者定義的區段。 然而,每個新增的命名段落必須以逗號(,)分隔。

每個此類區名必須在 INF 檔案中獨一無二,且必須遵循定義區名的一般規則。 欲了解更多規則資訊,請參閱 INF 檔案的一般語法規則。

欲了解更多如何安裝多功能裝置的資訊,請參閱 支援多功能裝置。

Examples

此範例展示了驅動程式套件如何使用 DDInstall。作業部分和DDInstall。服務 區塊可同時新增功能驅動程式與 PnP 上濾波器驅動程式。

[Example_DDInstall]
CopyFiles=example_copyfiles

[Example_DDInstall.HW]
AddReg=filter_addreg

[filter_addreg]
HKR,,"UpperFilters",0x00010000,"ExampleUpperFilter" ; [REG_MULTI_SZ](https://learn.microsoft.com/windows/desktop/SysInfo/registry-value-types) value 

[Example_DDInstall.Services]
AddService=ExampleFunctionDriver,0x00000002,function_ServiceInstallSection
AddService=ExampleUpperFilter,,filter_ServiceInstallSection

[function_ServiceInstallSection]
DisplayName    = %function_ServiceDesc%
ServiceType    = 1
StartType      = 3
ErrorControl   = 1
ServiceBinary  = %13%\ExampleFunctionDriver.sys

[filter_ServiceInstallSection]
DisplayName    = %filter_ServiceDesc%
ServiceType    = 1
StartType      = 3
ErrorControl   = 1
ServiceBinary  = %13%\ExampleUpperFilter.sys

也請參閱

AddReg

BitReg

DDInstall

DDInstall.Services

DelReg