Compartir a través de

Sección de DDInstall.COM INF

Cada sección DDInstall.COM modelos contiene una o varias directivas AddComServer inf que hacen referencia a otras secciones definidas por inf-writer en un archivo INF. Esta sección es compatible con Windows 11 versión 24H2 y versiones posteriores.

[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. Para obtener más información, consulte La directiva INF AddComServer y los servidores COM en general, consulte Clientes y servidores COM.

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

Esta entrada opcional especifica uno o más archivos INF proporcionados por el sistema que contienen secciones necesarias para instalar este dispositivo. If this entry is specified, a Needs entry is also required.

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

Esta entrada opcional especifica la sección que se debe procesar durante la instalación de este dispositivo. Normalmente, la sección es una sección de DDInstall.COM dentro de un archivo INF proporcionado por el sistema que aparece en una entrada Include. Sin embargo, puede ser cualquier sección a la que se haga referencia dentro de una sección de DDInstall.COM.

Remarks

COM binaries are installed into place using the CopyFiles directive in the DDInstall section. Los archivos binarios deben instalarse en una ubicación relativa a la ruta de acceso del almacén de controladores del paquete de controladores (por ejemplo, DIRID 13). Del mismo modo, la instalación de dispositivos escribe registros COM en ubicaciones de registro relativas al dispositivo.

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 sección debe tener las mismas decoraciones de plataforma y sistema operativo que sus secciones DDInstall relacionadas. Por ejemplo, una sección install-section-name.ntamd64 tendría una sección de install-section-name.ntamd64.COM correspondiente. Se debe hacer referencia a la sección DDInstall especificada en una entrada específica de dispositivos o modelos en la sección Modelos por fabricante del archivo INF. Las extensiones que no distinguen mayúsculas de minúsculas al nombre de la sección install-section que se muestra en la instrucción de sintaxis formal se pueden insertar en un nombre de sección de DDInstall.COM en archivos INF multiplataforma.

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