Sección INF DDInstall
Cada sección DDInstall contiene una directiva opcional DriverVer 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, que se enumeran 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 uninf universal de
Compatible con un INF universal
DriverVer=mm/dd/aaaa[,x.y.v.z]
Esta entrada opcional especifica la información de versión del paquete de controladores de .
Para obtener información sobre cómo especificar esta entrada, vea directiva INF DriverVer.
CopyFiles=@nombre de archivo | 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 inf-writer en las que se especifican los archivos relevantes para el dispositivo en el medio de origen para la transferencia al destino. La directiva
La entrada DefaultDestDir en 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, proporcione la ubicación en el medio de distribución de los archivos de controlador.
Para obtener más información, vea directiva INF CopyFiles.
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, consulte 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 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 complemento designa la "clave de software" ruta de acceso del Registro del dispositivo que se va a instalar.
Para obtener más información, vea directiva AddReg de INF.
AddProperty=add-property-section[,add-property-section]...
(Windows Vista y versiones posteriores) Hace referencia a una o varias secciones de archivos INF que modifican propiedades de dispositivo que se establecen para una instancia de dispositivo. Debe usar una directiva addProperty de INF solo para establecer una propiedad de instancia de dispositivo que sea nueva en Windows Vista o versiones posteriores de los sistemas operativos Windows.
En el caso de 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 de 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 Necesita.
Por ejemplo, los archivos INF para 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, esta sección con nombre es una sección DDInstall (o DDInstall.xxx) dentro de uno de los archivos INF que aparecen en una entrada Incluir. Sin embargo, puede ser cualquier sección a la que se haga referencia dentro de un DDInstall o DDInstall.sección xxx del INF incluido.
Por ejemplo, los archivos INF para los controladores de dispositivo que tienen el anterior incluyen entrada pueden especificar esta entrada de la siguiente manera:
Needs= KS.Registration, KSCAPTUR.Registration.NT, MSPCLOCK.Installation
FeatureScore=característicascore
Advertencia
La directiva
(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 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 Cómo clasifica Windows Drivers (Windows Vista y versiones posteriores).
Para obtener más información sobre esta directiva, vea directiva INF FeatureScore.
Nota
Aunque una sección de 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
(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
reinicio
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, vea 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 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 directiva INF 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 del Registro antiguas de una instalación anterior de este dispositivo.
Una especificación HKR en esta sección delete-registry designa el "clave de software" ruta de acceso del registro del dispositivo que se va a instalar.
Para obtener más información, consulte directiva INF DelReg.
DelProperty=del-property-section[,del-property-section]...
(Windows Vista y versiones posteriores) Hace referencia a una o varias secciones de archivos INF que eliminan 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.
En el caso de las propiedades de instancia de dispositivo que se introdujeron anteriormente en Windows Server 2003, Windows XP o Windows 2000, y que tienen 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=de sección de registro de bits [,sección de registro de bits]...
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 de registro de bits designa la "clave de software" ruta de acceso del Registro del dispositivo que se está instalando.
Para obtener más información, vea directiva BITReg inf.
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 para 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 de este tipo de dispositivo instalado manualmente que no es configurable por software también debe tener un DDInstall. Sección FactDef.
La directiva logConfig
Esta directiva es irrelevante para todos los componentes y controladores de nivel superior (no desndevice).
Para obtener más información, consulte directiva LogConfig de INF.
ProfileItems=profile-items-section [,profile-items-section]...
(Microsoft Windows 2000 y versiones posteriores de Windows) Esta directiva rara vez usada 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, vea 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 determinado 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, vea 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 directiva INF Ini2Reg.
RegisterDlls=register-dll-section [,register-dll-section]...
Esta directiva hace referencia a una o varias secciones INF que se usan para especificar archivos que son controles OLE y requieren el registro propio.
Para obtener más información, consulte directiva INF RegisterDlls.
UnregisterDlls=unregister-dll-section[,unregister-dll-section]...
Esta directiva hace referencia a una o varias secciones INF que se usan 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 unregisterDlls inf.
Observaciones
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-instalación, con o sin extensiones de plataforma. Por lo tanto, "DDInstall section" significa "una sección con nombre dentro de un INF, con el formato [install-section-name] o [install-section-name.ntxxx]". Al crear nombres para las secciones de 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 INF Models 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 siguientes secciones DDInstall:
- Una sección install-section-namesección .ntx86 que especifica las entradas para las instalaciones de dispositivos o controladores específicas de las plataformas basadas en x86.
- Una sección install-section-namesección .ntia64 que especifica las entradas para las instalaciones de dispositivos o controladores específicas de las plataformas basadas en Itanium.
- Una sección install-section-namesección .ntamd64 que especifica las entradas para las instalaciones de dispositivos o controladores específicas de las plataformas basadas en x64.
- Una sección install-section-namesección .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-namesección .ntarm64 que especifica las entradas para las instalaciones de dispositivos o controladores específicas de las plataformas basadas en Arm64.
- Una install-section-name o install-section-namesección .nt que especifica las entradas para 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 el definido por el sistema .nt, .ntx86, .ntia64, .ntamd64, .ntarmy extensiones de .ntarm64, consulte 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 del 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 de DDInstall hace referencia a una sección del registro de complementos que no se puede usar para almacenar información sobre los controladores de filtro superior o inferior, sobre dispositivos multifunción o sobre parámetros independientes del controlador, pero específicos del dispositivo. Si un dispositivo o controlador INF debe almacenar este tipo de información en el Registro, debe usar una directiva AddReg en su DDInstall. HW secciones, si las hay, para hacer referencia a otra sección de add-registry-section definida por INF-writer.
Dependiendo de la clase de configuración de dispositivo que se especificó en la sección versión de 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:
- Crear un archivo INF para un dispositivo windows SideShow-Compatible
- sección DDInstall de un archivo INF de red
- archivos INF para dispositivos de imagen fija
- archivos INF de para dispositivos WIA
- Requisitos de instalación de para componentes de red
- especificar directivas WDF en archivos INF
Ejemplos
En este ejemplo se muestra la expansión de las 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 anterior
[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
;
Consulte también
DDInstall. FactDef
DDInstall. LogConfigOverride