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

É necessária pelo menos uma diretiva AddComServer para registar servidores COM.

Entries

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

A diretiva AddComServer refere-se a uma secção com-server-install-install definida pelo escritor INF noutro local do ficheiro INF. A diretiva AddComServer pode ser usada uma ou mais vezes para registar múltiplos servidores COM. Para obter mais informações, consulte a diretiva INF AddComServer e para servidores COM em geral, consulte Clientes e servidores COM.

Inclui=nome do ficheiro.inf[,nome do ficheiro2.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. Se esta entrada for especificada, também é necessária uma entrada de Necessidades .

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

Os binários COM são instalados no local usando a diretiva CopyFiles na secçã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 o CoRegisterDeviceCatalog num fio de trabalho antes de chamar o CoCreateInstance. Chamar o CoRegisterDeviceCatalog disponibiliza os registos do servidor COM no processo para o runtime COM.

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.

Para mais informações sobre como usar as extensões .nt, .ntamd64 e . ntarm64 definidas pelo sistema, consulte Criação de Ficheiros INF para Múltiplas Plataformas e Sistemas Operativos.

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"

Ver também