Раздел INF InterfaceInstall32

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

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

Записи

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

Чтобы зарегистрировать экземпляр класса интерфейса, драйвер устройства должен вызвать IoRegisterDeviceInterface с этим GUID. Указанное значение GUID в этом разделе также может ссылаться на директиву INF AddInterface в INF DDInstall. Раздел интерфейсов.

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

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

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

Remarks

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

Каждое имя раздела install-interface-section должно быть уникальным в 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 в раздел установки интерфейса. Вы также можете удалить свойства класса интерфейса устройства, включив директивы INF DelProperty в раздел установки интерфейса. Однако следует использовать директиву 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 может использовать любую из необязательных директив, показанных здесь, чтобы указать операции установки, относящиеся к интерфейсу.

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

См. также

AddProperty

AddReg

BitReg

ClassInstall32

CopyFiles

DDInstall

DDInstall. Интерфейсы

DelFiles

DelProperty

DelReg

Ini2Reg

IoRegisterDeviceInterface

RenFiles

UpdateIniFields

UpdateInis