Sezione DDInstall.COM INF
Ogni sezione relativa ai modelli DDInstall.COM contiene una o più direttive INF AddComServer che fanno riferimento ad altre sezioni definite da INF-writer in un file INF. Questa sezione è supportata per Windows 11 versione 24H2 e successive.
[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]...]
Per registrare i server COM è necessaria almeno una direttiva AddComServer .
whse.
AddComServer=com-server-name,flags,com-server-install-section
La direttiva AddComServer fa riferimento a una sezione INF-writer-defined com-server-install-section altrove nel file INF. La direttiva AddComServer può essere usata una o più volte per registrare più server COM. Per altre informazioni, vedere direttiva INF AddComServer e per i server COM in generale, vedere Client e server COM.
Include=filename.inf[,filename2.inf]...
Questa voce facoltativa specifica uno o più file INF forniti dal sistema che contengono sezioni necessarie per installare il dispositivo. Se si specifica questa voce, è necessaria anche una voce Needs .
Needs=inf-section-name[,inf-section-name]...
Questa voce facoltativa specifica la sezione che deve essere elaborata durante l'installazione di questo dispositivo. In genere, la sezione è una sezione DDInstall.COM all'interno di un file INF fornito dal sistema elencato in una voce Di inclusione. Tuttavia, può trattarsi di qualsiasi sezione a cui viene fatto riferimento all'interno di una sezione DDInstall.COM.
Osservazioni:
I file binari COM vengono installati sul posto usando la direttiva CopyFiles nella sezione DDInstall. I file binari devono essere installati in un percorso relativo al percorso dell'archivio driver del pacchetto driver (ad esempio, DIRID 13). Analogamente, l'installazione del dispositivo scrive registrazioni COM nelle posizioni del Registro di sistema relative al dispositivo.
I client devono chiamare CoRegisterDeviceCatalog su un thread di lavoro prima di chiamare CoCreateInstance. La chiamata a CoRegisterDeviceCatalog rende disponibili le registrazioni del server COM nel processo per l'uso del runtime COM.
DDInstall.COM sezione deve avere le stesse decorazioni della piattaforma e del sistema operativo delle relative sezioni DDInstall. Ad esempio, una sezione install-section-name.ntamd64 avrà una sezione install-section-name.ntamd64.COM corrispondente. È necessario fare riferimento alla sezione DDInstall specificata in una voce specifica di dispositivo/modelli nella sezione Modelli per produttore del file INF. Le estensioni senza distinzione tra maiuscole e minuscole per il nome install-section indicato nell'istruzione di sintassi formale possono essere inserite in un nome di sezione DDInstall.COM di questo tipo nei file INF multipiattaforma.
Per altre informazioni su come usare le estensioni .nt, .ntamd64 e .ntarm64 definite dal sistema, vedere Creazione di file INF per più piattaforme e sistemi operativi.
Esempi
[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"