Sección INF DDInstall

Artículo
06/15/2023

Cada sección DDInstall por modelo contiene una directiva DriverVer opcional y una o varias directivas que hacen referencia a secciones con nombre adicionales en el archivo INF, que se muestran aquí con las directivas INF especificadas con más frecuencia, CopyFiles y AddReg, enumeradas primero.

Las secciones a las que hacen referencia estas directivas contienen instrucciones para instalar archivos de controlador y escribir cualquier información específica del dispositivo o específica del controlador en el registro.

[install-section-name] | 
[install-section-name.nt] | 
[install-section-name.ntx86] | 
[install-section-name.ntia64] | (Windows XP and later versions of Windows)
[install-section-name.ntamd64] | (Windows XP and later versions of Windows)
[install-section-name.ntarm] | (Windows 8 and later versions of Windows)
[install-section-name.ntarm64] (Windows 10 version 1709 and later versions of Windows)

[DriverVer=mm/dd/yyyy[,x.y.v.z]]
[CopyFiles=@filename | file-list-section[,file-list-section] ...]
[CopyINF=filename1.inf[,filename2.inf]...] (Windows XP and later versions of Windows)
[AddReg=add-registry-section[,add-registry-section]...]
[AddProperty=add-property-section[,add-property-section]...] (Windows Vista and later versions of Windows)
[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]...]
[DelProperty=del-property-section[,del-property-section]...] (Windows Vista and later versions of Windows)
[FeatureScore=featurescore]... (Windows Vista and later versions of Windows)
[BitReg=bit-registry-section[,bit-registry-section]...]
[LogConfig=log-config-section[,log-config-section]...]
[ProfileItems=profile-items-section[,profile-items-section]...] (Windows 2000 and later versions of Windows)
[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]...]
[ExcludeID=device-identification-string[,device-identification-string]...]... ((Windows XP and later versions of Windows)
[Reboot]

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.

Compatible con un INF universal

DriverVer=mm/dd/aaaa[,x.y.v.z]
Esta entrada opcional especifica información de versión para el paquete de controladores.

Para obtener información sobre cómo especificar esta entrada, vea Directiva INF DriverVer.

CopyFiles=@filename | file-list-section[,file-list-section] ...
Esta directiva 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 el escritor INF en las que se especifican los archivos relevantes para el dispositivo en el medio de origen para la transferencia al destino. La directiva CopyFiles es opcional, pero está presente en la mayoría de las secciones DDInstall .

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 la sección Version de este 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) .

CopyINF=filename1.inf[,filename2.inf]...
(Windows XP y versiones posteriores) Esta directiva hace que los archivos INF especificados se copien en el sistema de destino.

Para obtener más información, vea INF CopyINF (Directiva) de 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 escriben en el Registro o en las que se modifican las entradas de valor de las claves existentes.

Una especificación HKR en esta sección del registro de complementos designa la ruta de acceso del Registro de "clave de software" del dispositivo que se está instalando.

Para obtener más información, vea Inf AddReg Directive.

AddProperty=add-property-section[,add-property-section]...
(Windows Vista y versiones posteriores) Hace referencia a una o varias secciones de archivos INF que modifican las propiedades del dispositivo que se establecen para una instancia de dispositivo. Debe usar una directiva AddProperty INF solo para establecer una propiedad de instancia de dispositivo que sea nueva en Windows Vista o versiones posteriores de los sistemas operativos Windows.

Para las propiedades de instancia de dispositivo que se introdujeron anteriormente en Windows Server 2003, Windows XP o Windows 2000, y que tienen los valores de entrada del Registro correspondientes, debe seguir usando directivas AddReg inf para establecer las propiedades de la instancia del dispositivo. Estas directrices se aplican a las propiedades definidas por el sistema y a las propiedades personalizadas. Para obtener más información sobre cómo usar la directiva AddProperty , vea Using the INF AddProperty Directive and the INF DelProperty Directive.

Include=filename1.inf[,filename2.inf]...
Esta entrada opcional especifica uno o varios archivos INF adicionales proporcionados por el sistema 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 para los controladores de dispositivos que dependen de la compatibilidad con el streaming de kernel del sistema pueden especificar 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, una 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 dentro de un DDInstall o DDInstall.xxx sección del INF incluido.

Por ejemplo, los archivos INF para los controladores de dispositivos que tienen la entrada Include anterior pueden especificar esta entrada de la siguiente manera:

Needs= KS.Registration, KSCAPTUR.Registration.NT, MSPCLOCK.Installation

FeatureScore=featurescore

Advertencia

La directiva FeatureScore solo se procesa cuando se especifica directamente en la sección [DDInstall].

(Windows Vista y versiones posteriores) Esta directiva proporciona un criterio de clasificación adicional para los controladores que se basan en las características que admite un controlador. Por ejemplo, las puntuaciones de características se pueden definir para una clase de configuración de dispositivo que distingue entre los controladores en función de criterios específicos de la clase.

Para obtener más información sobre cómo se clasifican los controladores, consulte Clasificación de controladores de Windows (Windows Vista y versiones posteriores).

Para obtener más información sobre esta directiva, vea Directiva INF FeatureScore.

Nota

Aunque una sección DDInstall puede contener varias entradas featureScore , solo se procesa la primera entrada para la sección.

ExcludeID=device-identification-string[,device-identification-string]...

Advertencia

La directiva ExcludeID solo se procesa cuando se especifica directamente en la sección [DDInstall].

(Windows XP y versiones posteriores) Esta directiva especifica una o varias cadenas de identificación de dispositivos ( identificadores de hardware o identificadores compatibles). La sección DDInstall no instala dispositivos que tengan identificadores de dispositivo que coincidan con ninguno de los identificadores de hardware o los identificadores compatibles enumerados.

Reboot
Esta directiva indica que se debe solicitar al autor de la llamada que reinicie el sistema una vez completada la instalación.

Para obtener más información, consulte Directiva de reinicio inf.

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 el escritor inf que enumeran los archivos del destino que se van a eliminar.

Para obtener más información, vea INF DelFiles (Directiva).

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 se copien los archivos de origen relevantes para el dispositivo en el equipo de destino.

Para obtener más información, vea Inf RenFiles (Directiva RenFiles).

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.

Normalmente, esta directiva se usa para controlar las actualizaciones cuando un INF debe limpiar las entradas antiguas del Registro de una instalación anterior de este dispositivo.

Una especificación HKR en una sección de registro de eliminación designa la ruta de acceso del Registro de "clave de software" del dispositivo que se está instalando.

Para obtener más información, vea INF DelReg Directive.

DelProperty=del-property-section[,del-property-section]...
(Windows Vista y versiones posteriores) Hace referencia a una o varias secciones de archivos INF que eliminan las propiedades del dispositivo que se establecen para una instancia de dispositivo. Debe usar una directiva INF DelProperty solo para eliminar una propiedad de instancia de dispositivo que sea nueva en Windows Vista o versiones posteriores de Windows.

Para las propiedades de instancia de dispositivo que se introdujeron anteriormente en Windows Server 2003, Windows XP o Windows 2000, y que tienen los valores de entrada del Registro correspondientes, debe seguir usando directivas INF DelReg para eliminar las propiedades de la instancia del dispositivo. Estas directrices se aplican a las propiedades definidas por el sistema y a las propiedades personalizadas. Para obtener más información sobre cómo usar la directiva DelProperty , vea Using the INF AddProperty Directive and the INF DelProperty Directive.

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 .

Una especificación HKR en esta sección del Registro de bits designa la ruta de acceso del Registro de "clave de software" del dispositivo que se está instalando.

Para obtener más información, vea Inf BitReg Directive.

LogConfig=log-config-section[,log-config-section]...
Esta directiva hace referencia a una o varias secciones definidas por inf-writer dentro de un INF para un dispositivo enumerado por raíz o para un dispositivo instalado manualmente. En estas secciones con nombre, el INF de este tipo de dispositivo "detectado" o instalado manualmente especifica una o varias configuraciones lógicas de recursos de hardware relativos al bus que el dispositivo debe tener para estar operativo. El INF para un dispositivo instalado manualmente que no sea configurable por software también debe tener un DDInstall. Sección FactDef .

La directiva LogConfig nunca se usa para instalar dispositivos Plug and Play (PnP). Sin embargo, puede usar una sección INF DDInstall.LogConfigOverride para proporcionar una configuración de invalidación para dispositivos PnP.

Esta directiva es irrelevante para todos los componentes y controladores de nivel superior (no desdispositivo).

Para obtener más información, vea Inf LogConfig (Directiva).

ProfileItems=profile-items-section[,profile-items-section]...
(Microsoft Windows 2000 y versiones posteriores de Windows) Esta directiva que raramente se usa hace referencia a una o varias secciones definidas por el escritor inf que describen los elementos que se van a agregar o quitar del menú Inicio.

Para obtener más información, vea Inf ProfileItems (Directiva) .

UpdateInis=update-ini-section[,update-ini-section]...
Esta directiva que raramente se usa 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 determinado del mismo nombre se pueden especificar en la sección update-ini.

Para obtener más información, vea Inf UpdateInis (Directiva).

UpdateIniFields=update-inifields-section[,update-inifields-section]...
Esta directiva que raramente se usa hace referencia a una o varias secciones definidas por el escritor INF 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, vea Inf UpdateIniFields (Directiva).

Ini2Reg=ini-to-registry-section[,ini-to-registry-section]...
Esta directiva que raramente se usa hace referencia a una o varias secciones definidas por el escritor INF en las que las secciones o líneas de un archivo INI específico del dispositivo, proporcionada en el medio de origen, se moverán 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

A lo largo de la documentación del Kit de controladores de Windows ( WDK), el término DDInstall se usa para hacer referencia a un nombre de sección de instalación, con o sin extensiones de plataforma. Por lo tanto, "sección DDInstall" significa "una sección con nombre dentro de un INF, que tiene el formato [install-section-name] o [install-section-name.ntxxx]". Al crear nombres para las secciones DDInstall , debe incluir un prefijo específico del dispositivo, como [WDMPNPB003_Device] o [GPR400. Install.NT].

Se debe hacer referencia a cada sección DDInstall en una entrada específica de dispositivos o modelos en la sección Modelos INF por fabricante del archivo INF.

Excepto los dispositivos que no tienen archivos asociados que se van a transferir desde el medio de origen, un archivo INF que instala un controlador WDM en distintas plataformas del sistema operativo debe tener al menos una de las secciones DDInstall siguientes:

Una sección install-section-name.ntx86 que especifica las entradas de las instalaciones de dispositivos o controladores específicas de las plataformas basadas en x86.
Una sección install-section-name.ntia64 que especifica las entradas de las instalaciones de dispositivos o controladores específicas de las plataformas basadas en Itanium.
Una sección install-section-name.ntamd64 que especifica las entradas de las instalaciones de dispositivos o controladores específicas de las plataformas basadas en x64.
Una sección install-section-name.ntarm que especifica las entradas de las instalaciones de dispositivos o controladores específicas de las plataformas basadas en Arm.
Una sección install-section-name.ntarm64 que especifica las entradas para las instalaciones de dispositivos o controladores específicas de las plataformas basadas en Arm64.
Una sección install-section-name o install-section-name.nt que especifica las entradas de las instalaciones de dispositivos o controladores que no son específicas de una plataforma de hardware determinada.

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.

A partir de Windows 2000, un archivo INF que instala controladores debe tener secciones DDInstall.Services para especificar la información del servicio de controladores.

Cada directiva de una sección DDInstall puede hacer referencia a más de un nombre de sección. Sin embargo, cada sección con nombre adicional debe estar separada de la siguiente con una coma (,).

Cada nombre de sección debe ser único dentro del archivo INF y debe seguir las reglas generales para definir nombres de sección. Para obtener más información sobre estas reglas, vea Reglas de sintaxis general para archivos INF.

Se supone que cualquier directiva AddReg especificada en una sección DDInstall hace referencia a una sección del registro de complementos que no se puede usar para almacenar información sobre controladores de filtro superior o inferior, sobre dispositivos multifunción o sobre parámetros independientes del controlador, pero específicos del dispositivo. Si un inf del dispositivo o controlador debe almacenar este tipo de información en el registro, debe usar una directiva AddReg en su DDInstall sin codificar y decorar. Secciones de HW, si las hay, para hacer referencia a otra sección de add-registry-fined de INF-writer.

En función de la clase de configuración del dispositivo especificada en la sección Versión inf, se pueden especificar directivas específicas de clase adicionales en una sección DDInstall . Para obtener más información sobre las directivas específicas de clase, consulte los temas siguientes:

Ejemplos

En este ejemplo se muestra la expansión de las secciones DDInstall , Ser_Inst y Inp_Inst. En el ejemplo de la sección Modelos INF se hace referencia a estas secciones.

[Ser_Inst]
CopyFiles=Ser_CopyFiles, mouclass_CopyFiles

[Ser_CopyFiles]
sermouse.sys

[mouclass_CopyFiles] ; section name referenced by > 1 CopyFiles
mouclass.sys

[Inp_Inst]
CopyFiles=Inp_CopyFiles, mouclass_CopyFiles

[Inp_CopyFiles]
inport.sys

En el ejemplo siguiente se muestra la sección DDInstall de un archivo INF que instala un controlador WDM proporcionado por el sistema para un dispositivo de audio en varias plataformas de sistema operativo:

[WDMPNPB003_Device.NT]
Include=ks.inf, wdmaudio.inf
Needs=KS.Registration, WDMAUDIO.Registration.NT
CopyFiles=MSSB16.CopyList
AddReg=WDM_SB16.AddReg

En el ejemplo siguiente se muestran las secciones a las que hace referencia la entrada Needs anterior en los archivos ks.inf y wdmaudio.inf proporcionados por el sistema. En el ejemplo anterior, estos archivos se especifican en la entrada Includes . Cuando el instalador del dispositivo del sistema operativo procesa el nombre de la sección de instalación de este dispositivo. nt section, estas dos secciones siguientes también se procesan.

[KS.Registration]
; following AddReg= is actually a single line in the ks.inf file
AddReg=ProxyRegistration,CategoryRegistration,\
    TopologyNodeRegistration,PlugInRegistration,PinNameRegistration,\
    DeviceRegistration 
CopyFiles=KSProxy.Files,KSDriver.Files

[WDMAUDIO.Registration.NT]
AddReg=WDM.AddReg
CopyFiles=WDM.CopyFiles.Sys, WDM.CopyFiles.Drv
;
; INF-writer-defined add-registry and file-list sections
; referenced by preceding directives are omitted here for brevity
;