Seção DDInstall.COM INF
Cada seção DDInstall.COM per Models contém uma ou mais diretivas INF AddComServer que faz referência a outras seções definidas do criador de INF em um arquivo INF. Esta seção é suportada para o Windows 11 versão 24H2 e posterior.
[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]...]
Pelo menos uma diretiva AddComServer é necessária para registrar servidores COM.
Entradas
AddComServer=com-server-name,flags,com-server-install-section
A diretiva AddComServer faz referência a uma seção com-server-install-defined INF-writer-defined em outro lugar do arquivo INF. A diretiva AddComServer pode ser usada uma ou mais vezes para registrar vários servidores COM. Para mais informações, consulte Diretiva INF AddComServer. Para servidores COM em geral, consulte Clientes e servidores COM.
Include=filename.inf[,filename2.inf]...
Essa entrada opcional especifica um ou mais outros arquivos INF fornecidos pelo sistema que contêm as seções necessárias para instalar este dispositivo. Se essa entrada for especificada, uma entrada Needs também será necessária.
Needs=inf-section-name[,inf-section-name]...
Esta entrada opcional especifica a seção que deve ser processada durante a instalação deste dispositivo. Normalmente, a seção é uma seção DDInstall.COM dentro de um arquivo INF fornecido pelo sistema que está listado em uma entrada Include. No entanto, pode ser qualquer seção que é referenciada dentro de uma seção DDInstall.COM.
Comentários
Os binários COM são instalados no local usando a diretiva CopyFiles na seção DDInstall. Os binários devem ser instalados em um local relativo ao caminho de armazenamento de driver do pacote de driver (por exemplo, DIRID 13). Da mesma forma, a instalação do dispositivo grava registros COM em locais de registro relativos ao dispositivo.
Os clientes devem chamar CoRegisterDeviceCatalog em um thread de trabalho antes de chamar CoCreateInstance. Chamar CoRegisterDeviceCatalog torna os registros do servidor COM disponíveis no processo para o runtime COM usar.
A seção DDInstall.COM deve ter as mesmas decorações de plataforma e sistema operacional que suas seções DDInstall relacionadas. Por exemplo, uma seção install-section-name.ntamd64 teria uma seção install-section-name.ntamd64.COM correspondente. A seção DDInstall especificada deve ser referenciada em uma entrada específica do dispositivo/modelos na seção Models por fabricante do arquivo INF. As extensões que não diferenciam maiúsculas de minúsculas para o install-section-name mostrado na instrução de sintaxe formal podem ser inseridas em um nome de seção DDInstall.COM em arquivos INF de plataforma cruzada.
Para mais informações sobre como usar as extensões definidas pelo sistema .nt, .ntamd64 e .ntarm64, consulte Como criar arquivos INF para várias plataformas e sistemas operacionais.
Exemplos
[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"