Udostępnij przez

Sekcja DDInstall.COM INF

Każda sekcja DDInstall.COM modeli zawiera co najmniej jedną dyrektywę INF AddComServer odwołującą się do innych sekcji zdefiniowanych przez moduł zapisywania INF w pliku INF. Ta sekcja jest obsługiwana w systemie Windows 11 w wersji 24H2 lub nowszej.

[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. Aby uzyskać więcej informacji, zobacz dyrektywa INF AddComServer i ogólnie dla serwerów COM, zobacz COM Clients and Servers (Klienci i serwery COM).

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

Ten opcjonalny wpis określa jeden lub więcej innych plików INF dostarczanych przez system, które zawierają sekcje wymagane do zainstalowania tego urządzenia. If this entry is specified, a Needs entry is also required.

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

Ten opcjonalny wpis określa sekcję, która musi zostać przetworzona podczas instalacji tego urządzenia. Zazwyczaj sekcja jest sekcją DDInstall.COM w pliku INF dostarczonym przez system, który znajduje się w wpisie Dołączanie. Jednak może to być dowolna sekcja, do którego odwołuje się sekcja DDInstall.COM.

Remarks

COM binaries are installed into place using the CopyFiles directive in the DDInstall section. Pliki binarne powinny być instalowane w lokalizacji względem ścieżki magazynu sterowników pakietu sterowników (na przykład DIRID 13). Podobnie instalacja urządzenia zapisuje rejestracje COM w obszarze lokalizacji rejestru względnego urządzenia.

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 sekcja powinna mieć taką samą platformę i dekoracje systemu operacyjnego, jak powiązane sekcje DDInstall. Na przykład sekcja install-section-name.ntamd64 będzie miała odpowiednią sekcję install-section-name.ntamd64.COM. Określona sekcja DDInstall musi odwoływać się do wpisu specyficznego dla urządzenia/modeli w sekcji Modele dla poszczególnych producentów pliku INF. Rozszerzenia bez uwzględniania wielkości liter w nazwie install-section-name wyświetlanej w instrukcji składni formalnej można wstawić do takiej nazwy sekcji DDInstall.COM w plikach INF międzyplatformowych.

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