Compartilhar via

Seção DDInstall.COM INF

Cada seção DDInstall.COM por modelos contém uma ou mais diretivas INF AddComServer que fazem referência a outras seções definidas pelo gravador INF em um arquivo INF. Esta seção tem suporte 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]...]

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. Para obter mais informações, consulte a diretiva INF AddComServer e para servidores COM em geral, consulte clientes e servidores COM.

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

Essa entrada opcional especifica um ou mais arquivos INF fornecidos pelo sistema que contêm seções necessárias para instalar esse dispositivo. If this entry is specified, a Needs entry is also required.

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

Essa 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 em um arquivo INF fornecido pelo sistema que está listado em uma entrada Include. No entanto, pode ser qualquer seção referenciada em uma seção DDInstall.COM.

Remarks

COM binaries are installed into place using the CopyFiles directive in the DDInstall section. Os binários devem ser instalados em um local relativo ao caminho do repositório de driver do pacote de driver (por exemplo, DIRID 13). Da mesma forma, a instalação do dispositivo grava registros COM em locais relativos do registro do dispositivo.

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 seção deve ter a mesma plataforma e decorações do sistema operacional que as seções DDInstall relacionadas. Por exemplo, uma seção install-section-name.ntamd64 teria uma seção de install-section-name.ntamd64.COM correspondente. A seção DDInstall especificada deve ser referenciada em uma entrada específica de dispositivo/modelos na seção Modelos por fabricante do arquivo INF. As extensões que não diferenciam maiúsculas de minúsculas para o nome da seção de instalação mostrada na instrução de sintaxe formal podem ser inseridas em um nome de seção DDInstall.COM em arquivos INF multiplataforma.

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