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

Раздел INF DDInstall.COM

Каждый раздел DDInstall.COM моделей содержит одну или несколько директив INF AddComServer , ссылающихся на другие разделы, определенные в 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]...]

At least one AddComServer directive is required to register COM servers.

Entries

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

The AddComServer directive references an INF-writer-defined com-server-install-section elsewhere in the INF file. The AddComServer directive can be used one or more times to register multiple COM servers. Дополнительные сведения см. в директиве INF AddComServer и серверах COM, как правило, см. в разделе COM-клиентов и серверов.

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

Эта необязательная запись указывает один или несколько других системных INF-файлов, содержащих разделы, необходимые для установки этого устройства. If this entry is specified, a Needs entry is also required.

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

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

Remarks

COM binaries are installed into place using the CopyFiles directive in the DDInstall section. Двоичные файлы должны быть установлены в расположение относительно пути к хранилищу драйверов пакета драйверов (например, DIRID 13). Аналогичным образом установка устройства записывает регистрации COM в относительных расположениях реестра устройств.

Clients must call CoRegisterDeviceCatalog on a worker thread before calling CoCreateInstance. Calling CoRegisterDeviceCatalog makes the COM server registrations available in the process for the COM runtime to use.

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

For more information about how to use the system-defined .nt, .ntamd64, and .ntarm64 extensions see Creating INF Files for Multiple Platforms and Operating Systems.

Examples

[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"

See also

  • Last updated on