INF InterfaceInstall32 Section

Статья
06/15/2023

В этом разделе создается один или несколько новых классов интерфейса устройства. После создания нового класса установленные устройства и драйверы могут зарегистрировать поддержку нового класса интерфейса устройства, вызвав IoRegisterDeviceInterface.

[InterfaceInstall32]
 
{InterfaceClassGUID}=install-interface-section[,flags]
...

Записи

InterfaceClassGUID
Задает значение GUID, определяющее только что экспортируемый класс интерфейса устройства.

Чтобы зарегистрировать экземпляр класса интерфейса, драйвер устройства должен вызвать IoRegisterDeviceInterface с этим ИДЕНТИФИКАТОРом. На указанное значение GUID в этом разделе также может ссылаться директива INF AddInterface в INF DDInstall. Раздел "Интерфейсы".

Дополнительные сведения о создании GUID см. в разделе Использование guid в драйверах. Для определяемого системой класса интерфейса GUIDS см. соответствующие заголовки, например Ks.h для интерфейсов потоковой передачи ядра.

install-interface-section
Ссылается на раздел, определяемый inf-writer, возможно, с любым из системных расширений, в другом месте этого inf-файла.

flags
Если этот параметр указан, эта запись должна быть равна нулю.

Если указанный InterfaceClassGUID еще не установлен в системе, этот класс интерфейса устанавливается как соответствующий объект DDInstall. Раздел интерфейсов обрабатывается во время установки устройства или когда драйвер этого устройства выполняет первоначальный вызов IoRegisterDeviceInterface.

Каждое имя раздела интерфейса установки должно быть уникальным в ПРЕДЕЛАХ INF-файла и соответствовать общим правилам определения имен разделов. Дополнительные сведения об этих правилах см. в разделе Общие правила синтаксиса для ФАЙЛОВ INF.

Любой указанный раздел install-interface-section имеет следующую общую форму:

[interface-install-section] | 
[interface-install-section.nt] | 
[interface-install-section.ntx86] | 
[interface-install-section.ntia64] | (Windows XP and later versions of Windows)
[interface-install-section.ntamd64] | (Windows XP and later versions of Windows)
[interface-install-section.ntarm] | (Windows 8 and later versions of Windows)
[interface-install-section.ntarm64] (Windows 10 and later versions of Windows)
 
AddReg=add-registry-section[, add-registry-section] ...
[AddProperty=add-property-section[, add-property-section] ...]  (Windows Vista and later versions of Windows)
[Copyfiles=@filename | file-list-section[, file-list-section] ...]
[DelReg=del-registry-section[, del-registry-section] ...]
[DelProperty=del-property-section[, del-property-section] ...]  (Windows Vista and later versions of Windows)
[BitReg=bit-registry-section[,bit-registry-section]...]
[Delfiles=file-list section[, file-list-section] ...]
[Renfiles=file-list-section[, file-list-section] ...]
[UpdateInis=update-ini-section[,update-ini-section]...]
[UpdateIniFields=update-inifields-section[,update-inifields-section]...]
[Ini2Reg=ini-to-registry-section[,ini-to-registry-section]...]
...

Дополнительные сведения о записях в разделе interface-install-section см. в разделе INF DDInstall.

Начиная с Windows Vista, можно задать свойства класса интерфейса устройства , включив директивы INF AddProperty в раздел interface-install. Вы также можете удалить свойства класса интерфейса устройства, включив директивы INF DelProperty в раздел interface-install. Однако директиву AddProperty или DelProperty следует использовать только для изменения свойств класса интерфейса устройства, которые являются новыми в Windows Vista или более поздних версиях операционных систем Windows. Для свойств класса интерфейса устройства, которые были представлены в Windows Server 2003, Windows XP или Windows 2000 и имеют соответствующие записи значений реестра, следует продолжать использовать директивы INF AddReg и директивы INF DelReg для задания и удаления свойств класса интерфейса устройства. Эти рекомендации применяются к системным и пользовательским свойствам. Дополнительные сведения об использовании директив AddProperty и DelProperty см. в разделах Использование директивы INF AddProperty и директивы INF DelProperty.

Директива AddReg ссылается на один или несколько разделов реестра надстроек, которые задают сведения об интерфейсе устройства в реестре во время установки этого интерфейса.

Сведения реестра об этом классе интерфейса должны содержать по крайней мере понятное имя для нового класса интерфейса устройства и любые сведения, необходимые компонентам более высокого уровня при открытии и использовании этого интерфейса.

Кроме того, такой раздел install-interface-section может использовать любую из дополнительных директив, показанных здесь, для указания операций установки для конкретного интерфейса.

Дополнительные сведения об использовании системных расширений .nt, .ntx86, .ntia64, .ntamd64, .ntarm, .ntarm64 см. в статье Создание INF-файлов для нескольких платформ и операционных систем.