INF DefaultInstall 节

注意

如果要生成 通用驱动程序包,则仅当此部分具有体系结构修饰时有效,例如 [DefaultInstall.NTAMD64]。

注意

在 INF 中使用 DefaultInstall 和 Manufacturer 部分将导致通用 INF 验证失败,并可能导致安装行为不一致。 请参阅 使用通用 INF 文件。

如果用户在选择并按住 INF 文件名后选择“安装”菜单项(或右键单击),则会访问 INF 文件的 DefaultInstall 节。 在 Windows 10 版本 1903 和更高版本的 Windows 上,如果 INF 满足基元驱动程序的要求,则可以在许多驱动程序包 API 中使用具有 DefaultInstall 的 INF。

[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]...] ...

条目

通用 INF 不支持所有有效的条目。 下面列出了哪些指令在通用 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

Needs=inf-section-name[,inf-section-name]...
此可选条目指定在安装此设备期间必须处理的系统提供的 INF 文件中的节。 通常,此类命名节是 DDInstall (或 DDInstall)。xxx) 包含在 Include 条目中列出的 INF 文件之一中的节。 但是,它可以是此类 DDInstall 或 DDInstall 中引用的任何部分。包含的 INF 的 xxx 部分。

例如,具有上述 Include 条目的设备驱动程序的 INF 文件按如下所示指定此条目:

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

通用 INF 不支持

Delfiles=file-list-section[,file-list-section]...
此指令引用一个或多个 INF 编写器定义的节,其中列出了要删除的目标上的文件。

有关详细信息,请参阅 INF DelFiles 指令。

Renfiles=file-list-section[,file-list-section]...
此指令引用一个或多个 INF 编写器定义的节,其中列出了在目标上重命名的文件,然后再将与设备相关的源文件复制到目标计算机。

有关详细信息,请参阅 INF RenFiles 指令。

DelReg=del-registry-section[,del-registry-section]...
此指令引用一个或多个 INF 编写器定义的部分,这些节在安装设备期间指定要从注册表中删除键和/或值项。

有关详细信息,请参阅 INF DelReg 指令。

BitReg=bit-registry-section[,bit-registry-section]...
此指令引用修改 REG_BINARY 类型的现有注册表项的一个或多个 INF 编写器定义的节。 有关详细信息,请参阅 INF AddReg 指令。

有关详细信息,请参阅 INF BitReg 指令。

ProfileItems=profile-items-section[,profile-items-section]...
此指令引用一个或多个 INF 编写器定义的部分,这些节描述要添加到“开始”菜单或从中删除的项。

有关详细信息,请参阅 INF ProfileItems 指令。

UpdateInis=update-ini-section[,update-ini-section]...
此很少使用的指令引用一个或多个 INF 编写器定义的节,并指定源 INI 文件,在安装过程中,要从中将特定节或行读入同名的目标 INI 文件。 (可选)可以在 update-ini 节中指定同名的指定源 INI 文件中逐行修改目标上的现有 INI 文件。

有关详细信息,请参阅 INF UpdateInis 指令。

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]...
此指令引用一个或多个 INF 节,这些节用于指定 OLE 控件的文件,并且需要自我注册。

有关详细信息,请参阅 INF RegisterDlls 指令。

UnregisterDlls=unregister-dll-section[,unregister-dll-section]...
此指令引用一个或多个 INF 节,这些节用于指定 OLE 控件的文件,并且需要自我取消删除(自删除)。

有关详细信息,请参阅 INF UnregisterDlls 指令。

Remarks

DefaultInstall 节不得用于设备安装。 仅对未与设备节点(devnode)关联的类筛选器驱动程序、文件系统筛选器和内核驱动程序服务的安装使用 DefaultInstall 节。

如果在 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