Раздел INF DDInstall.HW
DDInstall. Разделы HW обычно используются для установки многофункциональных устройств, установки драйверов фильтров PnP, а также для настройки любых доступных пользователем сведений о конкретных устройствах, но не зависящих от драйвера, в реестре, будь то с помощью явных директив AddReg или с записями Include и Needs .
[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] ...]
Записи
Не все допустимые записи поддерживаются в универсальном INF. Ниже перечислены директивы, допустимые в универсальном INF, а какие нет.
Поддерживается в универсальном INF
AddReg=add-registry-section[,add-registry-section]...
Ссылается на один или несколько разделов add-registry-defined , определяемых inf-writer, в другом месте INF-файла для устройств, на которые распространяется этот параметр DDInstall. Раздел HW . Раздел add-registry обычно устанавливает фильтры и (или) сохраняет сведения об устройствах в реестре. Спецификация HKR в таком разделе add-registry указывает аппаратный ключ устройства, подраздел реестра для конкретного устройства, содержащий сведения об устройстве. Аппаратный ключ также называется ключом устройства. Дополнительные сведения см. в разделе Деревья и ключи реестра для устройств и драйверов. Пакет драйвера может добавлять параметры с помощью INF-файла, используя спецификацию HKR в разделе реестра надстроек, на который ссылается раздел DDInstall.HW.
Дополнительные сведения см. в разделе Inf AddReg Directive.
Include=имя_файла. inf[,filename2.inf]...
Указывает один или несколько дополнительных системных INF-файлов, содержащих разделы, необходимые для установки этого устройства. Если указана эта запись, обычно это запись Needs .
Needs=inf-section-name[,inf-section-name]...
Указывает именованные разделы, которые должны обрабатываться во время установки этого устройства. Как правило, такой именованный раздел является DDInstall. Раздел HW в предоставленном системой INF-файле, который указан в записи Include . Однако это может быть любой раздел, на который ссылается такая установка DDInstall. Раздел HW включенного INF.
Не поддерживается в универсальном INF
DelReg=del-registry-section[,del-registry-section]...
Ссылается на одно или несколько файлов delete-registry-section, определенных inf-writer, в другом месте INF-файла для драйверов устройств, на которые распространяется этот раздел DDInstall . Такой раздел удаления реестра удаляет устаревшие сведения о реестре для ранее установленного устройства или драйвера с целевого компьютера. Спецификация HKR в таком разделе delete-registry обозначает тот же подраздел, что и для AddReg.
Эта директива используется редко, за исключением INF-файла , который обновляет предыдущую установку этих же устройств или моделей, перечисленных в разделе о производителях на модели, где определено имя этого раздела DDInstall . Дополнительные сведения см. в разделе Директива INF DelReg.
BitReg=bit-registry-section[,bit-registry-section] ...
Является допустимым в этом разделе, но почти никогда не используется. Спецификация HKR в разделе битового реестра, на который ссылается ссылка, обозначает тот же подраздел, что и для AddReg. Дополнительные сведения см. в разделе Директива BitReg INF.
Комментарии
Расширения без учета регистра для install-section-name , показанного в формальной синтаксической инструкции, можно вставить в такую установку DDInstall. Имя раздела HW в кроссплатформенных INF-файлах. Дополнительные сведения об использовании системных расширений .nt, .ntx86, .ntia64, .ntamd64, .ntarm и .ntarm64 см. в статье Создание INF-файлов для нескольких платформ и операционных систем.
Любой DDInstall. Раздел HW должен содержать одно из следующих элементов:
- Директива AddReg .
- Запись Include , указывающая другой INF-файл. В этом случае — DDInstall. Раздел HW также должен содержать соответствующую запись Needs , которая указывает раздел в другом INF-файле. Этот раздел используется для настройки необходимых сведений о реестре.
Каждая директива в DDInstall. Раздел HW может ссылаться на несколько разделов, определенных inf-writer. Однако каждый дополнительный именованный раздел должен быть отделен от следующего запятой (,).
Каждое такое имя раздела должно быть уникальным в INF-файле и соответствовать общим правилам определения имен разделов. Дополнительные сведения об этих правилах см. в разделе Общие правила синтаксиса для ФАЙЛОВ INF.
Дополнительные сведения об установке многофункциональных устройств см. в разделе Поддержка многофункциональных устройств.
Примеры
В этом примере показано, как пакет драйвера может использовать DDInstall. Разделы HW и 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
См. также раздел
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по