Partager via

Section DDInstall.COM INF

Chaque section par modèle DDInstall.COM contient une ou plusieurs directives INF AddComServer qui font référence à d’autres sections définies par l’enregistreur INF dans un fichier INF. Cette section est prise en charge pour Windows 11 version 24H2 et ultérieure.

[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. Pour plus d’informations, consultez la directive INF AddComServer et pour les serveurs COM en général, consultez Clients et serveurs COM.

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

Cette entrée facultative spécifie un ou plusieurs autres fichiers INF fournis par le système qui contiennent des sections nécessaires pour installer cet appareil. If this entry is specified, a Needs entry is also required.

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

Cette entrée facultative spécifie la section qui doit être traitée pendant l’installation de cet appareil. En règle générale, la section est une section DDInstall.COM dans un fichier INF fourni par le système répertorié dans une entrée Include. Toutefois, il peut s’agir de n’importe quelle section référencée dans une section DDInstall.COM.

Remarks

COM binaries are installed into place using the CopyFiles directive in the DDInstall section. Les fichiers binaires doivent être installés dans un emplacement par rapport au chemin du magasin de pilotes du package de pilotes (par exemple, DIRID 13). De même, l’installation de l’appareil écrit les inscriptions COM sous les emplacements de Registre relatifs de l’appareil.

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 section doit avoir les mêmes décorations de plateforme et de système d’exploitation que leurs sections DDInstall associées. Par exemple, une section install-section-name.ntamd64 aurait une section install-section-name.ntamd64.COM correspondante. La section DDInstall spécifiée doit être référencée dans une entrée spécifique aux appareils/modèles sous la section Modèles par fabricant du fichier INF. Les extensions qui ne respectent pas la casse du nom de section d’installation indiqué dans l’instruction de syntaxe formelle peuvent être insérées dans un nom de section DDInstall.COM dans des fichiers INF multiplateformes.

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