Section INF DDInstall.COM
Chaque section DDInstall.COM par modèle contient une ou plusieurs directives INF AddComServer qui font référence à d'autres sections définies par l'écrivain INF dans un fichier INF. Cette section est prise en charge pour Windows 11 version 24H2 et ultérieures.
[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]...]
Au moins une directive AddComServer est nécessaire pour enregistrer les serveurs COM.
Entries
AddComServer=com-server-name,flags,com-server-install-section
La directive AddComServer fait référence à une section d'installation de serveur COM définie par l'auteur de l'INF dans le fichier INF. La directive AddComServer peut être utilisée une ou plusieurs fois pour enregistrer plusieurs serveurs COM. Pour plus d'informations, voir la directive INF AddComServer et pour les serveurs COM en général, voir 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 à l'installation de cet appareil. Si cette entrée est spécifiée, une entrée Needs est également requise.
Needs=nom-de-la-section-inf[,nom-de-la-section-inf]...
Cette entrée facultative spécifie la section qui doit être traitée lors de l'installation de cet appareil. Généralement, la section est une section DDInstall.COM dans un fichier INF fourni par le système et répertorié dans une entrée Include. Cependant, il peut s'agir de n'importe quelle section référencée dans une section DDInstall.COM.
Notes
Les fichiers binaires COM sont installés à l'aide de la directive CopyFiles de la section DDInstall. Les fichiers binaires doivent être installés à un emplacement relatif au chemin d'accès au pilote du package (par exemple, DIRID 13). De même, l'installation des appareils écrit les enregistrements COM dans des emplacements de registre relatifs aux appareils.
Les clients doivent appeler CoRegisterDeviceCatalog sur un threading avant d'appeler CoCreateInstance. L'appel de CoRegisterDeviceCatalog rend les enregistrements du serveur COM disponibles dans le processus pour que le runtime COM puisse les utiliser.
La section DDInstall.COM doit avoir les mêmes décorations de plate-forme et de système d'exploitation que les sections DDInstall correspondantes. Par exemple, une section install-section-name.ntamd64 doit avoir 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 à un appareil/modèle dans la section Models du fichier INF. Les extensions insensibles à la casse du nom de la section install indiquées dans l'instruction syntaxique formelle peuvent être insérées dans un tel nom de section DDInstall.COM dans les fichiers INF multiplateformes.
Pour plus d'informations sur l'utilisation des extensions .nt, .ntamd64 et .ntarm64 définies par le système, reportez-vous à la section Création de fichiers INF pour plusieurs plates-formes et systèmes d'exploitation.
Exemples
[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"