Раздел Inf DefaultInstall

Примечание

Если вы создаете универсальный пакет драйверов, этот раздел действителен только в том случае, если он имеет оформление архитектуры, например [DefaultInstall.NTAMD64].

Примечание

Использование разделов DefaultInstall и Manufacturer в inf приведет к сбоям универсальной проверки INF и может привести к несогласованности при установке. См . раздел Использование универсального INF-файла.

Доступ к разделу DefaultInstall INF-файла осуществляется, если пользователь выбирает пункт меню "Установить", выбрав и удерживая (или щелкнув правой кнопкой мыши) имя INF-файла. В Windows 10 версии 1903 и более поздних версиях Windows inf с DefaultInstall можно использовать во многих 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]...] ...

Записи

Не все допустимые записи поддерживаются в универсальном INF. Ниже перечислены директивы, допустимые в универсальном INF, а какие нет.

Поддерживается в универсальном INF

CopyFiles=@filename | file-list-section[,file-list-section] ...
Эта необязательная директива указывает один именованный файл для копирования с исходного носителя в место назначения или ссылается на один или несколько разделов, определенных средством записи INF, которые указывают файлы для передачи с исходного носителя в место назначения.

Запись DefaultDestDir в разделе DestinationDirs inf указывает назначение для копирования любого отдельного файла. В разделах SourceDisksNames и SourceDisksFiles или в дополнительных файлах INF, указанных в записи LayoutFile раздела Версия этого INF, указывается расположение файлов драйверов на носителе распространения.

Дополнительные сведения см. в разделе Директива INF CopyFiles.

CopyINF=имя_файла1.inf[,имя_файла2.inf]...
(Windows XP и более поздние версии Windows.) Эта директива приводит к копированию указанных INF-файлов в целевую систему.

Дополнительные сведения см. в разделе Inf CopyINF Directive.

AddReg=add-registry-section[,add-registry-section]...
Эта директива ссылается на один или несколько разделов, определяемых inf-writer, в которых новые подразделы, возможно, с начальными записями значений, записываются в реестр или в которых изменяются записи значений существующих ключей.

Дополнительные сведения см. в разделе Inf AddReg Directive.

Include=filename1.inf[,filename2.inf]...
Эта необязательная запись указывает один или несколько дополнительных системных INF-файлов, содержащих разделы, необходимые для установки этого устройства и (или) драйвера. Если указана эта запись, обычно это запись Needs .

Например, системные INF-файлы для драйверов устройств, которые зависят от поддержки потоковой передачи ядра в системе, указывают эту запись следующим образом:

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

Needs=inf-section-name[,inf-section-name]...
Эта необязательная запись указывает разделы в предоставленных системой INF-файлах, которые должны быть обработаны во время установки этого устройства. Как правило, такой именованный раздел является DDInstall (или DDInstall.xxx) раздел в одном из INF-файлов, перечисленных в записи Include . Однако это может быть любой раздел, на который ссылается такая установка DDInstall или DDInstall.xxx раздела включенного INF.

Например, INF-файлы для драйверов устройств с предыдущей записью Include указывают эту запись следующим образом:

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

Не поддерживается в универсальном INF

Delfiles=file-list-section[,file-list-section]...
Эта директива ссылается на один или несколько разделов, определяемых inf-writer, перечисляя файлы в целевом объекте для удаления.

Дополнительные сведения см. в разделе Директива INF DelFiles.

Renfiles=file-list-section[,file-list-section]...
Эта директива ссылается на один или несколько разделов, определенных inf-writer, в которых перечислены файлы, которые необходимо переименовать в назначении, прежде чем исходные файлы, относящиеся к устройству, будут скопированы на целевой компьютер.

Дополнительные сведения см. в разделе Директива INF RenFiles.

DelReg=del-registry-section[,del-registry-section]...
Эта директива ссылается на один или несколько разделов, определенных inf-writer, в которых ключи и /или значения записей указываются для удаления из реестра во время установки устройств.

Дополнительные сведения см. в разделе Директива INF DelReg.

BitReg=bit-registry-section[,bit-registry-section]...
Эта директива ссылается на один или несколько разделов, определенных inf-writer, в которых изменяются существующие записи значений реестра типа REG_BINARY . Дополнительные сведения см. в разделе Inf AddReg Directive.

Дополнительные сведения см. в разделе Директива BitReg INF.

ProfileItems=profile-items-section[,profile-items-section]...
Эта директива ссылается на один или несколько разделов, определяемых inf-writer, которые описывают элементы, которые нужно добавить или удалить из меню "Пуск".

Дополнительные сведения см. в разделе Директива INF ProfileItems.

UpdateInis=update-ini-section[,update-ini-section]...
Эта редко используемая директива ссылается на один или несколько разделов, определенных inf-writer, указывая исходный INI-файл, из которого конкретный раздел или строка в таком разделе должны быть считаны в целевой INI-файл с тем же именем во время установки. При необходимости в разделе update-ini можно указать построчное изменение существующего INI-файла в назначении из указанного исходного INI-файла с тем же именем.

Дополнительные сведения см. в разделе Директива INF UpdateInis.

UpdateIniFields=update-inifields-section[,update-inifields-section]...
Эта редко используемая директива ссылается на один или несколько определенных inf-writer разделов, в которых указываются изменения в строках ini-файла для конкретного устройства.

Дополнительные сведения см. в разделе Директива INF UpdateIniFields.

Ini2Reg=ini-to-registry-section[,ini-to-registry-section]...
Эта редко используемая директива ссылается на один или несколько определенных inf-writer разделов, в которых разделы или строки из файла 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.

Комментарии

Разделы DefaultInstall не должны использоваться для установки устройств. Используйте разделы DefaultInstall только для установки драйверов фильтров классов, фильтров файловой системы и служб драйверов ядра, не связанных с узлом устройства (devnode).

При использовании DefaultInstall на Windows 10 версии 1903 и более поздних версиях Windows рекомендуется, чтобы INF-файл соответствовал требованиям драйвера-примитива.

Примечание

INF-файл пакета драйверов , содержащего раздел Manufacturer, не должен содержать раздел 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-файлов для нескольких платформ и операционных систем.

Примеры

В следующем примере показан типичный раздел DefaultInstall :

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

См. также раздел

Установка DDInstall

DriverVer

LogConfig