Раздел 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