Partilhar via

Secçã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 secçã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]...]

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]...

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

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.

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 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.

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 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 Modelos por fabricante do arquivo INF. As extensões que não diferenciam maiúsculas de minúsculas para o install-section-name mostradas na instrução de sintaxe formal podem ser inseridas em tal nome de seção DDInstall.COM em arquivos INF de plataforma cruzada.

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