Sección DDInstall.COM de INF
Cada sección DDInstall.COM por modelos contiene una o varias directivas AddComServer de INF que hacen referencia a otras secciones INF-writer-defined en un archivo INF. Esta sección se admite para Windows 11 versión 24H2 y 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]...]
Se requiere al menos una directiva AddComServer para registrar servidores COM.
Entries
AddComServer=com-server-name,flags,com-server-install-section
La directiva AddComServer hace referencia a unaINF-writer-defined com-server-install-section en otra parte del archivo INF. La directiva AddComServer se puede usar una o varias veces para registrar varios servidores COM. Para obtener más información, consulte Directiva AddComServer de INF y, para 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. Si se especifica esta entrada, también se requiere una entrada Needs.
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, es una sección 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 DDInstall.COM.
Comentarios
Los archivos binarios COM se instalan en su lugar mediante la directiva CopyFiles en la sección DDInstall. Los archivos binarios deben instalarse en una ubicación relativa a la ruta 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.
Los clientes deben llamar a CoRegisterDeviceCatalog en un subproceso de trabajo antes de llamar a CoCreateInstance. Al llamar a CoRegisterDeviceCatalog , los registros del servidor COM están disponibles en el proceso para que el entorno de ejecución COM los use.
La sección DDInstall.COM 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 un nombre de sección 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 Models por fabricante del archivo INF. Las extensiones que no distinguen mayúsculas de minúsculas de install-section-name que se muestra en la instrucción de sintaxis formal se pueden insertar en este nombre de sección DDInstall.COM en archivos INF multiplataforma.
Para obtener más información sobre cómo usar las extensiones .nt, .ntamd64 y .ntarm64 definidas por el sistema, consulte Creación de archivos INF para varias plataformas y sistemas operativos.
Ejemplos
[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"