Раздел 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"