INF DefaultInstall 區塊

注意

如果你正在建構 通用驅動程式套件,此段僅在包含架構裝飾時有效,例如 [DefaultInstall.NTAMD64]。

注意

在 INF 中同時使用 DefaultInstall 和 Manufacturer 區塊會導致通用 INF 驗證失敗,並可能導致安裝行為不一致。 請參見 使用通用 INF 檔案。

使用者在選擇並長按(或右鍵點擊)INF檔案名稱後,選擇「安裝」選單項目後,即可存取INF檔案的 DefaultInstall 區段。 在 Windows 10 1903 及之後版本的 Windows 上,若符合原始驅動程式的需求,帶有 DefaultInstall 的 INF 可以在許多驅動套件 API 中使用。

[DefaultInstall] | 
[DefaultInstall.nt] | 
[DefaultInstall.ntx86] | 
[DefaultInstall.ntia64] | (Windows XP and later versions of Windows)
[DefaultInstall.ntamd64] | (Windows XP and later versions of Windows)
[DefaultInstall.ntarm] | (Windows 8 and later versions of Windows)
[DefaultInstall.ntarm64] (Windows 10 version 1709 and later versions of Windows)
 
[CopyFiles=@filename | file-list-section[,file-list-section] ...]
[CopyINF=filename1.inf[,filename2.inf]...]
[AddReg=add-registry-section[,add-registry-section]...]
[Include=filename1.inf[,filename2.inf]...]
[Needs=inf-section-name[,inf-section-name]...]
[Delfiles=file-list-section[,file-list-section]...]
[Renfiles=file-list-section[,file-list-section]...]
[DelReg=del-registry-section[,del-registry-section]...]
[BitReg=bit-registry-section[,bit-registry-section]...]
[ProfileItems=profile-items-section[,profile-items-section]...]
[UpdateInis=update-ini-section[,update-ini-section]...]
[UpdateIniFields=update-inifields-section[,update-inifields-section]...]
[Ini2Reg=ini-to-registry-section[,ini-to-registry-section]...]
[RegisterDlls=register-dll-section[,register-dll-section]...]
[UnregisterDlls=unregister-dll-section[,unregister-dll-section]...] ...

Entries

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

支援於通用中程彈

CopyFiles=@filename | file-list-section[,file-list-section] ...
此選用指令要指定一個指定檔案從來源媒介複製至目的地,或參考一個或多個由 INF 編譯器定義的區段,指定從來源媒體傳輸到目的地的檔案。

INF的DestinationDirs區段中的DefaultDestDir條目指定了任何單一檔案的複製目的地。 SourceDisksNames 與 SourceDisksFiles 區塊,或本 INF 版本區塊 LayoutFile 條目中指定的額外 INF,提供驅動程式檔案在發行媒介上的位置。

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

CopyINF=filename1.inf[,filename2.inf]...
(Windows XP 及後續版本的 Windows。)此指令會將指定的 INF 檔案複製到目標系統。

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

AddReg=add-registry-section[,add-registry-section]...
此指令參考一個或多個 INF 寫入者定義的區段,該區段指定新子鍵(可能帶有初始值條目)寫入登錄檔,或修改現有鍵值條目。

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

Include=filename1.inf[,filename2.inf]...
此選用條目指定一個或多個系統提供的額外 INF 檔案,包含安裝此裝置及/或驅動程式所需的區段。 如果此條目有指定,通常也會標示 為需求 條目。

例如,依賴系統核心串流支援的裝置驅動程式 INF 檔案會指定此項如下:

Include= ks.inf,kscaptur.inf,ksfilter.inf

需求=inf-section-name[,inf-section-name]...
此選用項目指定系統提供的 INF 檔案中必須在安裝此裝置時處理的區段。 通常,這類命名區段稱為 DDInstall (或稱 DDInstall)。xxx) 在 包含條目 中列出的 INF 檔案中的一個區段。 然而,它可以是任何在此類 DDInstall 或 DDInstall 中被引用的區段。包含的 INF 的 xxx 部分。

例如,包含前述 Include 條目的裝置驅動程式 INF 檔案,會指定以下條目:

Needs= KS.Registration,KSCAPTUR.Registration.NT,MSPCLOCK.Installation

通用 INF 不支援

Delfiles=檔案清單區段[,檔案列表區段]...
此指令引用一個或多個由 INF 撰寫者定義的區段,列出目標上要刪除的檔案。

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

Renfiles=檔案清單區段[,檔案列表區段]...
此指令引用一個或多個 INF 撰寫者定義的區段,列出在目標端需重新命名的檔案,然後才將與裝置相關的原始檔案複製到目標電腦。

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

DelReg=del-registry-section[,del-registry-section]...
此指令參考一個或多個 INF 編入者定義的區段,指定在裝置安裝時從登錄檔移除的金鑰和/或值項目。

欲了解更多資訊,請參閱 INF外邦政府指令。

BitReg=位元登錄區段[,位元登錄區]...
此指令引用一個或多個由 INF 撰寫者定義的區段,該區段中修改了 REG_BINARY 型的現有登錄值項目。 欲了解更多資訊,請參閱 INF AddReg 指令。

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

ProfileItems=profile-items-section[,profile-items-section]...
此指令引用一個或多個由 INF writer 定義的區段,描述要新增或移除開始選單的項目。

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

UpdateInis=update-ini-section[,update-ini-section]...
此指令很少使用,會參考一個或多個 INF 寫入者定義的區段,指定一個來源 INI 檔案,該區段內的特定區段或行在安裝時要讀入同名的目的地 INI 檔。 可選擇性地,在 update-ini 區塊中逐行修改目的地上來自指定來源 INI 檔案的現有 INI 檔案。

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

UpdateIniFields=update-inifields-section[,update-inifields-section]...
此指令很少使用,會參考一個或多個 INF 寫入者定義的區段,指定裝置特定 INI 檔案行內的修改內容。

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

Ini2Reg=ini-to-registry-section[,ini-to-registry-section]...
此指令少用,會參考一個或多個 INF 寫入者定義的區段,將來源媒體中裝置專屬 INI 檔案的區段或行移入登錄檔。

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

RegisterDlls=register-dll-section[,register-dll-section]...
此指令引用一個或多個用於指定 OLE 控制且需自我註冊檔案的 INF 區段。

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

UnregisterDlls=unregister-dll-section[,unregister-dll-section]...
此指令提及一個或多個用於指定 OLE 控制且需自我取消註冊(自我移除)檔案的 INF 區段。

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

Remarks

DefaultInstall 區段不得用於裝置安裝。 僅在安裝類別過濾器驅動程式、檔案系統過濾器及與裝置節點(devnode)無關聯的核心驅動服務時,使用預設安裝區段。

若在 Windows 10 版本 1903 及更新版本的 Windows 上使用 DefaultInstall,建議 INF 檔案符合原始驅動程式的要求。

注意

若驅動程式套件要進行數位簽署,則其 INF 檔案若有製造商區段,必須不包含 INF DefaultInstall 區段。 欲了解更多關於簽署司機包裹的資訊,請參閱 「司機簽署」。

注意

與 DDInstall 區段不同, DefaultInstall 區段不能包含 DriverVer 或 LogConfig 指令。

若要從裝置安裝應用程式安裝 DefaultInstall 區段,請使用以下呼叫 InstallHinfSection:

InstallHinfSection(NULL,NULL,TEXT("DefaultInstall 132 path-to-inf\infname.inf"),0); 

欲了解更多如何使用系統定義的 .nt、 .ntx86、 .ntia64、 .ntamd64、 .ntarm 及 .ntarm64 擴充名的資訊,請參閱「 為多平台與作業系統建立 INF 檔案」。

Examples

以下範例展示了典型 的 DefaultInstall 區段:

[DefaultInstall]
CopyFiles=MyAppWinFiles, MyAppSysFiles, @SRSutil.exe
AddReg=MyAppRegEntries

也請參閱

DDInstall

DriverVer

LogConfig