Поделиться через

Раздел INF DDInstall.COM

  • Статья

Каждый раздел DDInstall.COM модели содержит одну или несколько директив INF AddComServer, ссылающихся на другие разделы, определенные в INF-записи, в INF-файле. Этот раздел поддерживается для Windows 11 версии 24H2 и более поздних версий.

[install-section-name.COM] |
[install-section-name.nt.COM] |
[install-section-name.ntamd64.COM] |
[install-section-name.ntarm64.COM]

AddComServer = com-server-name, [flags], com-server-install-section
[Include=filename.inf[,filename2.inf]...]
[Needs=inf-section-name[,inf-section-name]...]

Для регистрации COM-серверов требуется по крайней мере одна директива AddComServer .

Операции

AddComServer=com-server-name,flags,com-server-install-section

Директива AddComServer ссылается на inf-writer-defined com-server-install-section в другом месте INF-файла. Директива AddComServer может использоваться один или несколько раз для регистрации нескольких COM-серверов. Дополнительные сведения см. в директиве INF AddComServer и серверах COM, как правило, см. в разделе COM-клиентов и серверов.

Include=filename.inf[,filename2.inf]...

Эта необязательная запись указывает один или несколько других системных INF-файлов, содержащих разделы, необходимые для установки этого устройства. Если указана эта запись, также требуется запись "Потребности ".

Needs=inf-section-name[,inf-section-name]...

Эта необязательная запись указывает раздел, который необходимо обработать во время установки этого устройства. Как правило, раздел является разделом DDInstall.COM в системном INF-файле, который указан в записи Include. Однако это может быть любой раздел, на который ссылается DDInstall.COM раздел.

Замечания

Двоичные файлы COM устанавливаются на месте с помощью директивы CopyFiles в разделе DDInstall. Двоичные файлы должны быть установлены в расположение относительно пути к хранилищу драйверов пакета драйверов (например, DIRID 13). Аналогичным образом установка устройства записывает регистрации COM в относительных расположениях реестра устройств.

Клиенты должны вызывать CoRegisterDeviceCatalog в рабочем потоке перед вызовом CoCreateInstance. Вызов CoRegisterDeviceCatalog делает регистрацию COM-сервера доступными в процессе использования среды выполнения COM.

DDInstall.COM раздел должен иметь те же элементы платформы и операционной системы, что и связанные разделы DDInstall. Например, раздел install-section-name.ntamd64 будет иметь соответствующий раздел install-section-name.ntamd64.COM. Указанный раздел DDInstall должен ссылаться на запись устройства или модели в разделе "Модели производителя" в INF-файле. Расширения без учета регистра в имя раздела установки, показанное в формальной инструкции синтаксиса, можно вставить в такое имя раздела DDInstall.COM в кроссплатформенных INF-файлах.

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

Примеры

[Device_Install.COM]
AddComServer   = VendorComServer,, VendorComServer_Inst

[VendorComServer_Inst]
ServerType     = 1 ; in-proc
ServerBinary   = %13%\Vendor_ComServer.dll
AddComClass    = {bb2b85ab-9473-42e5-8d1a-0f01d3879879},, Vendor_ComClass_Inst

[Vendor_ComClass_Inst]
Description    = %Vendor_ComClass_Desc%
ThreadingModel = Neutral

[Strings]
%Vendor_ComClass_Desc%="Vendor Com Server"

См. также