Sección Inf DefaultInstall
Nota
Si va a crear un paquete de controladores universales, esta sección solo es válida si tiene una decoración de arquitectura, por ejemplo [DefaultInstall.NTAMD64].
Nota
El uso de secciones DefaultInstall y Manufacturer en inf provocará errores de validación de INF universales y puede provocar comportamientos de instalación incoherentes. Consulte Uso de un archivo INF universal.
Se tiene acceso a la sección DefaultInstall de un archivo INF si un usuario selecciona el elemento de menú "Instalar" después de seleccionar y mantener (o hacer clic con el botón derecho) en el nombre de archivo INF. En Windows 10 versión 1903 y versiones posteriores de Windows, se puede usar un INF con DefaultInstall en muchas API de paquete de controladores si cumple los requisitos de un controlador primitivo.
[DefaultInstall] |
[DefaultInstall.nt] |
[DefaultInstall.ntx86] |
[DefaultInstall.ntia64] | (Windows XP and later versions of Windows)
[DefaultInstall.ntamd64] | (Windows XP and later versions of Windows)
[DefaultInstall.ntarm] | (Windows 8 and later versions of Windows)
[DefaultInstall.ntarm64] (Windows 10 version 1709 and later versions of Windows)
[CopyFiles=@filename | file-list-section[,file-list-section] ...]
[CopyINF=filename1.inf[,filename2.inf]...]
[AddReg=add-registry-section[,add-registry-section]...]
[Include=filename1.inf[,filename2.inf]...]
[Needs=inf-section-name[,inf-section-name]...]
[Delfiles=file-list-section[,file-list-section]...]
[Renfiles=file-list-section[,file-list-section]...]
[DelReg=del-registry-section[,del-registry-section]...]
[BitReg=bit-registry-section[,bit-registry-section]...]
[ProfileItems=profile-items-section[,profile-items-section]...]
[UpdateInis=update-ini-section[,update-ini-section]...]
[UpdateIniFields=update-inifields-section[,update-inifields-section]...]
[Ini2Reg=ini-to-registry-section[,ini-to-registry-section]...]
[RegisterDlls=register-dll-section[,register-dll-section]...]
[UnregisterDlls=unregister-dll-section[,unregister-dll-section]...] ...
Entradas
No todas las entradas válidas se admiten en un INF universal. A continuación se enumeran las directivas que son válidas en un INF universal y que no lo son.
Compatible con un INF universal
CopyFiles=@filename | file-list-section[,file-list-section] ...
Esta directiva opcional especifica un archivo con nombre que se va a copiar del medio de origen al destino, o hace referencia a una o varias secciones definidas por INF-writer que especifican los archivos que se van a transferir desde el medio de origen al destino.
La entrada DefaultDestDir de la sección DestinationDirs del INF especifica el destino de cualquier archivo único que se va a copiar. Las secciones SourceDisksNames y SourceDisksFiles , o un INF adicional especificado en la entrada LayoutFile de esta sección Versión de INF, proporcionan la ubicación en los medios de distribución de los archivos de controlador.
Para obtener más información, vea Inf CopyFiles (Directiva) de INF.
CopyINF=filename1.inf[,filename2.inf]...
(Windows XP y versiones posteriores de Windows). Esta directiva hace que los archivos INF especificados se copien en el sistema de destino.
Para obtener más información, vea Directiva INF CopyINF.
AddReg=add-registry-section[,add-registry-section]...
Esta directiva hace referencia a una o varias secciones definidas por INF-writer en las que se especifican nuevas subclaves, posiblemente con entradas de valor iniciales, que se van a escribir en el Registro o en las que se modifican las entradas de valor de las claves existentes.
Para obtener más información, vea Inf AddReg Directive.
Include=filename1.inf[,filename2.inf]...
Esta entrada opcional especifica uno o varios archivos INF proporcionados por el sistema adicionales que contienen secciones necesarias para instalar este dispositivo o controlador. Si se especifica esta entrada, normalmente es una entrada Needs .
Por ejemplo, los archivos INF del sistema para los controladores de dispositivo que dependen de la compatibilidad con el streaming de kernel del sistema especifican esta entrada de la siguiente manera:
Include= ks.inf,kscaptur.inf,ksfilter.inf
Needs=inf-section-name[,inf-section-name]...
Esta entrada opcional especifica secciones dentro de los archivos INF proporcionados por el sistema que se deben procesar durante la instalación de este dispositivo. Normalmente, esta sección con nombre es DDInstall (o DDInstall).xxx) sección dentro de uno de los archivos INF que aparecen en una entrada Include . Sin embargo, puede ser cualquier sección a la que se haga referencia en este tipo de DDInstall o DDInstall.xxx sección del INF incluido.
Por ejemplo, los archivos INF para los controladores de dispositivo que tienen la entrada Include anterior especifican esta entrada de la siguiente manera:
Needs= KS.Registration,KSCAPTUR.Registration.NT,MSPCLOCK.Installation
No se admite en un INF universal
Delfiles=file-list-section[,file-list-section]...
Esta directiva hace referencia a una o varias secciones definidas por INF-writer que enumeran los archivos en el destino que se van a eliminar.
Para obtener más información, vea Directiva INF DelFiles.
Renfiles=file-list-section[,file-list-section]...
Esta directiva hace referencia a una o varias secciones definidas por INF-writer que enumeran los archivos que se van a cambiar de nombre en el destino antes de que los archivos de origen pertinentes del dispositivo se copien en el equipo de destino.
Para obtener más información, vea Inf RenFiles (Directiva RenFiles de INF).
DelReg=del-registry-section[,del-registry-section]...
Esta directiva hace referencia a una o varias secciones definidas por INF-writer en las que se especifican claves o entradas de valor que se van a quitar del Registro durante la instalación de los dispositivos.
Para obtener más información, vea Directiva INF DelReg.
BitReg=bit-registry-section[,bit-registry-section]...
Esta directiva hace referencia a una o varias secciones definidas por INF-writer en las que se modifican las entradas de valor del Registro existentes de tipo REG_BINARY . Para obtener más información, vea Inf AddReg Directive.
Para obtener más información, vea Inf BitReg Directive.
ProfileItems=profile-items-section[,profile-items-section]...
Esta directiva hace referencia a una o varias secciones definidas por INF-writer que describen los elementos que se van a agregar o quitar del menú Inicio.
Para obtener más información, consulte Directiva INF ProfileItems.
UpdateInis=update-ini-section[,update-ini-section]...
Esta directiva rara vez usada hace referencia a una o varias secciones definidas por INF-writer, especificando un archivo INI de origen desde el que se va a leer una sección o línea determinada dentro de dicha sección en un archivo INI de destino con el mismo nombre durante la instalación. Opcionalmente, las modificaciones de línea a línea en un archivo INI existente en el destino desde un archivo INI de origen especificado del mismo nombre se pueden especificar en la sección update-ini.
Para obtener más información, vea Directiva INF UpdateInis.
UpdateIniFields=update-inifields-section[,update-inifields-section]...
Esta directiva rara vez usada hace referencia a una o varias secciones definidas por INF-writer en las que se especifican modificaciones dentro de las líneas de un archivo INI específico del dispositivo.
Para obtener más información, consulte Directiva INF UpdateIniFields.
Ini2Reg=ini-to-registry-section[,ini-to-registry-section]...
Esta directiva rara vez usada hace referencia a una o varias secciones definidas por inf-writer en las que las secciones o líneas de un archivo INI específico del dispositivo, proporcionada en el medio de origen, se van a mover al registro.
Para obtener más información, vea INF Ini2Reg Directive.
RegisterDlls=register-dll-section[,register-dll-section]...
Esta directiva hace referencia a una o varias secciones INF usadas para especificar archivos que son controles OLE y requieren el registro propio.
Para obtener más información, vea Inf RegisterDlls (Directiva).
UnregisterDlls=unregister-dll-section[,unregister-dll-section]...
Esta directiva hace referencia a una o varias secciones INF usadas para especificar archivos que son controles OLE y requieren un registro automático (eliminación automática).
Para obtener más información, vea Directiva inf UnregisterDlls.
Comentarios
Las secciones DefaultInstall no se deben usar para las instalaciones de dispositivos. Use secciones DefaultInstall solo para la instalación de controladores de filtro de clase, filtros de sistema de archivos y servicios de controladores de kernel que no están asociados a un nodo de dispositivo (devnode).
Si usa DefaultInstall en Windows 10 versión 1903 y versiones posteriores de Windows, se recomienda que el archivo INF cumpla los requisitos de un controlador primitivo.
Nota
El archivo INF de un paquete de controladores que tiene una sección Fabricante no debe contener una sección DefaultInstall de INF si el paquete de controladores se va a firmar digitalmente. Para obtener más información sobre la firma de paquetes de controladores, consulte Firma de controladores.
Nota
A diferencia de una sección DDInstall , una sección DefaultInstall no puede contener directivas DriverVer o LogConfig .
Para instalar una sección DefaultInstall desde una aplicación de instalación de dispositivos, use la siguiente llamada a InstallHinfSection:
InstallHinfSection(NULL,NULL,TEXT("DefaultInstall 132 path-to-inf\infname.inf"),0);
Para obtener más información sobre cómo usar las extensiones .nt, .ntx86, .ntia64, .ntamd64, .ntarm y .ntarm64 definidas por el sistema, vea Crear archivos INF para varias plataformas y sistemas operativos.
Ejemplos
En el ejemplo siguiente se muestra una sección predeterminada típica:
[DefaultInstall]
CopyFiles=MyAppWinFiles, MyAppSysFiles, @SRSutil.exe
AddReg=MyAppRegEntries