Definici≤n del archivo de informaci≤n para la instalaci≤n (.inf)

Un archivo bßsico .inf contiene las secciones siguientes (los archivos .inf mßs complejos pueden tener secciones adicionales). Los nombres de secci≤n en negrita son palabras clave reservadas. Los nombres de secci≤n en cursiva son nombres arbitrarios creados por el autor del archivo .inf:

• Secci≤n Version
• Secciones Install
• Secciones Copy File (CopyFiles)
• Secciones Rename Files (RenFiles)
• Secciones Delete Files (DelFiles)
• Secciones Update .ini File (UpdateInis)
• Secciones Update .ini Fields (UpdateIniFields)
• Secciones Add Registry (AddReg)
• Secciones Delete Registry (DelReg)
• Secciones Add Ini File to Registry (Ini2Reg)
• Secciones Update Config.sys (UpdateCfgSys)
• Secciones Update Autoexec.bat (UpdateAutoBat)
• Secci≤n DestinationDirs
• Secci≤n SourceDisksNames
• Secci≤n SourceDisksFiles
• Secci≤n Strings
• Secci≤n Opcional Components

Secci≤n Version

[Version]
Signature="$Chicago$"
LayoutFile=nombre archivo.inf
Define el encabezado estßndar para los archivos .inf de Windows. Tenga en cuenta que, si la firma (Signature) no es $Chicago$, Windows no aceptarß el archivo como un archivo .inf para ninguna de las clases de dispositivo reconocidas por Windows.

Observe que el reconocimiento de la cadena de la firma no distingue may·sculas y min·sculas. Por ello puede usar tanto $Chicago$ como $CHICAGO$, por ejemplo.

nombre archivo.INF
Nombre del archivo .inf que contiene la informaci≤n de distribuci≤n (archivos y discos de origen) necesaria para instalar este componente. Esta lφnea es opcional. Si no se proporciona en ning·n otro lugar, las secciones SourceDisksNames y SourceDisksFiles se deben especificar en este archivo .inf.

En el ejemplo siguiente se muestra una secci≤n Version com·n:

[Version]
Signature="$CHICAGO$"

Secci≤n Install

Copyfiles = secci≤n-lista-archivo[,<secci≤n-lista-archivo>]...
Renfiles = secci≤n-lista-archivo[,secci≤n-lista-archivo]...
Delfiles = secci≤n-lista-archivo[,secci≤n-lista-archivo]...
UpdateInis = secci≤n-update-ini[,secci≤n-update-ini]...
UpdateIniFields = secci≤n-update-inifields[,secci≤n-update-inifields]...
AddReg = secci≤n-add-registry[,secci≤n-add-registry]...
DelReg = secci≤n-del-registry[,secci≤n-del-registry]...
Ini2Reg = secci≤n-ini-to-registry[,secci≤n-ini-to-registry]...
UpdateCfgSys = secci≤n-update-config
UpdateAutoBat =secci≤n-update-autoexec

Identifica las secciones adicionales del archivo .inf que contienen informaci≤n acerca de la instalaci≤n del componente.

No todos los tipos de elemento mostrados en la sintaxis anterior son necesarios u obligatorios en una secci≤n Install. Si se usa un tipo de elemento, debe especificar el nombre de una secci≤n en el archivo .inf. (Una excepci≤n es el elemento CopyFiles, que puede usar el carßcter "@" junto con un nombre de archivo para copiar un ·nico archivo sin especificar un nombre de secci≤n.) El nombre de secci≤n debe estar formado por caracteres imprimibles.

En una secci≤n Install, s≤lo se puede usar un elemento de cada tipo. En un elemento puede enumerarse mßs de un nombre de secci≤n pero cada nombre adicional debe ir precedido por una coma.

nombre-secci≤n-install Si asigna el nombre [DefaultInstall] a la secci≤n install, se ejecutarß al hacer clic con el bot≤n secundario del mouse (rat≤n) en el archivo .inf y seleccionar Install. ╔sta tambiΘn es la secci≤n que se ejecuta al seleccionar un archivo .inf como la opci≤n de instalaci≤n mediante el Asistente Cabpack.

En el ejemplo siguiente se muestra una secci≤n Install tφpica. Contiene elementos Copyfilesy AddRegque identifican las secciones que contienen la informaci≤n acerca de los archivos que se instalarßn.

[MiAplicaci≤n]
Copyfiles=MyAppWinFiles, MyAppSysFiles, @SRSutil.exe
AddReg=MyAppRegEntries

En este ejemplo, observe que al cambiar el nombre de la secci≤n [MiAplicaci≤n] a [DefaultInstall], la secci≤n Install se ejecutarß al hacer clic con el bot≤n secundario del mouse en el archivo .inf y seleccionar Install.

El elemento CopyFiles proporciona una notaci≤n especial que permite que un ·nico archivo se copie directamente desde la lφnea copy. Puede copiar un archivo individual si antepone al nombre de archivo el sφmbolo @. El destino de los archivos copiados con esta notaci≤n es el directorio DefaultDestDir, tal como se define en la secci≤n DestinationDirs. En el ejemplo siguiente se muestra c≤mo copiar archivos individuales:

CopyFiles=SeccionArchivo1,@miarchivo.txt,@otroarchivo.txt,NombreUltimaSeccion

Secciones Copy Files (CopyFiles)

[nombre-secci≤n-CopyFiles]
nombre-archivo-destino[, nombre-archivo-origen][,nombre-archivo-temporal][,indicador]
[nombre-archivo-destino[,nombre-archivo-origen][, nombre-archivo-temporal]][,indicador]

Enumeran los nombres de los archivos que se copiarßn de un disco de origen a un directorio de destino. El disco de origen y el directorio de destino asociados a cada archivo se especifican en otras secciones del archivo .inf. El nombre secci≤n-lista-archivo debe aparecer en el elemento CopyFiles de una secci≤n Install.

Tenga en cuenta que puede especificar la copia de un ·nico archivo en el elemento CopyFiles de la propia secci≤n Install, sin tener que generar una secci≤n CopyFiles. Para ello, use el carßcter especial "@" para forzar la copia de un ·nico archivo. Hay un ejemplo de utilizaci≤n del carßcter "@" en un elemento del tipo CopyFiles en el tema "Referencia" de la secci≤n Install. La copia de un ·nico archivo realizada de esta forma estß algo limitada porque los nombres de archivos de origen y de destino deben coincidir en este caso y no se puede usar un archivo temporal.

nombre-archivo-destino
Nombre del archivo de destino. ╔ste serß tambiΘn el nombre del archivo de origen, si no se proporciona ninguno.

nombre-archivo-origen
Nombre del archivo de origen. Si coinciden los nombres de los archivos de origen y de destino para la operaci≤n de copia, este elemento no es necesario.

nombre-archivo-temporal
Nombre de un archivo temporal para la operaci≤n de copia de archivos. El instalador copia el archivo de origen pero le da el nombre del archivo temporal. La pr≤xima vez que se inicie el sistema operativo, cambiarß el nombre del archivo temporal por el del archivo de destino. Esto es ·til para copiar archivos a un destino que estß abierto o que estß usando Windows.

indicador
Parßmetro opcional que se utiliza para realizar acciones especiales durante el proceso de instalaci≤n. Se pueden usar varios indicadores si se suman sus valores para crear un indicador combinado. Se pueden usar los siguientes indicadores vßlidos:

En el ejemplo siguiente se copian tres archivos:

[CopyTheseFilesSec]
archivo11 ; copia archivo11
archivo21, archivo22, archivo23 ; copia archivo22, nombrarlo temporalmente archivo23
archivo31, archivo32 ; copia archivo32 a archivo31

Todos los nombres de archivo de origen que se usan en este ejemplo deben definirse en una secci≤n SourceDisksFiles y el n·mero de disco l≤gico que aparece en la secci≤n SourceDisksFiles debe haberse definido en una secci≤n SourceDisksNames . TambiΘn puede usar un archivo Layout.inf para proporcionar esta informaci≤n.

Secciones Rename Files (RenFiles)

[nombre-secci≤n-rename-files]
nombre-archivo-nuevo, nombre-archivo-anterior
.
.
Enumeran los nombres de los archivos cuyo nombre se va a cambiar. El nombre de la secci≤n debe aparecer en un elemento Renfiles de una secci≤n Install del archivo .inf.

nombre-archivo-nuevo
Nombre nuevo del archivo.

nombre-archivo-anterior
Nombre anterior del archivo.

En el ejemplo siguiente se cambia el nombre de archivo42 a archivo41, archivo52 a archivo51 y archivo62 a archivo61:

[RenameOldFilesSec]
archivo41, archivo42
archivo51, archivo52
archivo61, archivo62

Todos los nombres de archivo que se utilizan en este ejemplo (archivo42, archivo52 y archivo62) deben definirse en una secci≤n SourceDisksFiles y los n·meros de disco l≤gico que aparecen en la secci≤n SourceDisksFiles deben haberse definido en una secci≤n SourceDisksNames.

Secciones Delete Files (DelFiles)

[ secci≤n-lista-archivo]
nombre-archivo[,,,indicador]
.

Una secci≤n DelFiles enumera los nombres de los archivos que se van a eliminar. El nombre secci≤n-lista-archivo debe aparecer en el elemento Delfiles de una secci≤n Install.

nombre-archivo
Identifica el archivo que se va a eliminar.

indicador
Parßmetro opcional que se usa para forzar que Windows elimine el archivo especificado en el elemento si se estß utilizando durante el proceso de instalaci≤n. Para indicar a Windows que introduzca en una cola la operaci≤n de eliminaci≤n de archivo hasta que se haya reiniciado el equipo, establezca el valor del parßmetro indicador a 1. Si un archivo marcado con un parßmetro indicador=1 no se puede eliminar porque se estß utilizando, se reiniciarß el sistema una vez que se haya completado la instalaci≤n del dispositivo.

Si no usa el parßmetro indicador con su valor establecido a 1 junto con un parßmetro nombre-archivo, el archivo no se elimina del equipo si se estß utilizando cuando se ejecuta la secci≤n DelFiles.

En el ejemplo siguiente se eliminan tres archivos:

[DeleteOldFilesSec]
archivo1
archivo2
archivo3

Secciones Update .ini File (UpdateInis)

[ nombre-secci≤n-update-ini]
archivo-ini, secci≤n-ini, [entrada-ini-anterior], [entrada-ini-nueva], [indicadores]
.
.
Reemplaza, elimina o agrega entradas completas en el archivo .ini especificado. El nombre de la secci≤n, nombre-secci≤n-update-ini, debe aparecer en el elemento UpdateInis de una secci≤n Install en el archivo .inf.

archivo-ini
Nombre del archivo .ini que contiene la entrada que se va a cambiar. Para obtener mßs informaci≤n acerca de c≤mo especificar el nombre de archivo .ini, consulte los comentarios mßs adelante.

secci≤n-ini
Nombre de la secci≤n que contiene la entrada que se va a cambiar.

entrada-ini-anterior
Opcional. Normalmente tiene el formato Clave=Valor.

entrada-ini-nueva
Opcional. Normalmente tiene el formato Clave=Valor. Tanto la clave como el valor pueden especificar cadenas reemplazables. Por ejemplo, la clave y el valor especificado en el parßmetro entrada-ini-nueva podrφa ser %Cadena1%, donde la cadena que sustituye a %Cadena1% se define en la secci≤n Strings del archivo .inf.

indicadores
Indicadores de acci≤n opcionales. Pueden ser uno de los valores siguientes:

Puede usar el carßcter comodφn asterisco (*) cuando especifique la clave y el valor, y se interpretarß de forma correcta.

El nombre archivo-ini puede ser una cadena o una clave de cadena. Una clave de cadena tiene la forma %claveCad%, donde claveCad se define en la secci≤n Strings del archivo .inf. En cualquier caso, el nombre debe ser un nombre de archivo vßlido.

Debe incluir el nombre de la carpeta que contiene el archivo, pero debe proporcionarse como un identificador de directorio l≤gico (LDID) en lugar de como un nombre real. El instalador reemplaza un LDID con un nombre real durante la instalaci≤n.

Un LDID tiene la forma %ldid%, donde ldid es uno de los identificadores predefinidos o un identificador definido en la secci≤n DestinationDirs. Tenga en cuenta que, cuando se sustituyen las constantes LDID_BOOT y LDID_BOOTHOST, la barra diagonal inversa se incluye en la ruta de acceso. Por ejemplo, LDID_BOOT podrφa sustituirse por C:\. No obstante, en el archivo .inf puede usar el carßcter barra inversa o no usarlo. Por ejemplo, tanto "%30%boot.ini" como "%30%\boot.ini" se pueden usar para hacer referencia a BOOT..ini en la raφz de la unidad de inicio.

Los ejemplos siguientes ilustran la utilizaci≤n de elementos individuales de una secci≤n Update .ini File en un archivo .inf:

%11%\sample.ini, Section1,, Value1=2 ; agrega nueva entrada
%11%\sample.ini, Section2, Value3=*, ; elimina entrada anterior
%11%\sample.ini, Section4, Value5=1, Value5=4 ; reemplaza entrada anterior

El conjunto de elementos siguiente de una secci≤n del tipo Update .ini File de un archivo .inf funcionan juntos para operar en la secci≤n Boot de SYSTEM..ini. La capacidad de establecer condiciones integrada en el parßmetro indicadores de los elementos del archivo .inf se usa para agregar la entrada "comm.drv=comm.drv" a la secci≤n Boot a menos que la entrada "comm.drv=*vcoscomm.drv" o "comm.drv=*r0dmdcom.drv" exista en la secci≤n Boot, en cuyo caso la entrada existente se mantiene y la entrada "comm.drv=comm.drv" no se agrega al archivo .ini. En otras palabras, tras ejecutar las cuatro entradas del archivo .inf que se muestran debajo, habrß una entrada "comm.drv=" en la secci≤n Boot del archivo .ini: "comm.drv=*vcoscomm.drv", "comm.drv=*r0dmdcom.drv" o "comm.drv=comm.drv."

system.ini, boot, "comm.drv=*vcoscomm.drv","~CommDrvTemp~=*", 3
system.ini, boot, "comm.drv=*r0dmdcom.drv","~CommDrvTemp~=*", 3
system.ini, boot,,"comm.drv=comm.drv"
system.ini, boot, "~CommDrvTemp~=*","comm.drv=*", 3

Secciones Update .ini Fields (UpdateIniFields)

[ nombre-secci≤n-update-inifields]
archivo-ini, secci≤n-ini, nombre-perfil, [campo-anterior], [campo-nuevo],[indicadores]
.
.
Reemplazan, agregan y eliminan campos en el valor de una entrada .ini dada. A diferencia del tipo de secci≤n Update .ini File, en este tipo de secci≤n se reemplaza, agrega o elimina una parte de un valor de una entrada del archivo .ini en lugar de todo el valor. El nombre de la secci≤n, nombre-secci≤n-update-inifields, debe aparecer en el elemento UpdateIniFields de una secci≤n Install del archivo .inf.

archivo-ini
Nombre del archivo .ini que contiene la entrada que se va a cambiar. Para obtener mßs informaci≤n acerca de c≤mo especificar el nombre del archivo .ini, consulte el tema que describe el tipo de secci≤n Update .ini File.

secci≤n-ini
Nombre de la secci≤n del archivo .ini que contiene la entrada que se va a cambiar.

nombre-perfil
Nombre de la entrada que se va a cambiar.

campo-anterior
Valor del campo que se va a eliminar.

campo-nuevo
Valor del campo que se va a agregar, si no estß allφ ya.

indicadores
Especifica si se debe tratar el parßmetro campo-anterior y el parßmetro campo-nuevo como si tuvieran un carßcter comodφn y quΘ carßcter separador se va a utilizar cuando se anexe un campo nuevo a una entrada del archivo .ini. Puede ser uno de los valores siguientes:

Cualquier comentario en una lφnea del archivo .ini se quitarß ya que podrφa no ser aplicable despuΘs de realizar los cambios. Cuando los campos de esta lφnea del archivo .ini se procesen, los espacios, tabulaciones y comas se usarßn como delimitadores de campo. No obstante, se utiliza un espacio como separador cuando el campo nuevo se anexa a la lφnea.

Secciones Add Registry (AddReg)

[ secci≤n-add-registry]
cadena-raφz-reg, [subclave], [nombre-valor], [indicador], [valor]
[cadena-raφz-reg, [subclave], [nombre-valor], [indicador], [valor]]
.
.
Agregan subclaves o nombres de valor al Registro y establecen opcionalmente el valor. El nombre secci≤n-add-registry debe aparecer en un elemento del tipo AddReg de una secci≤n Install.

cadena-raφz-reg
Nombre raφz del Registro. Pueden ser uno de los valores siguientes:

HKCR igual que HKEY_CLASSES_ROOT
HKCU igual que HKEY_CURRENT_USER
HKLM igual que HKEY_LOCAL_MACHINE
HKU igual que HKEY_USERS.
HKR significa relativo a la clave pasada en GenInstallEx

subclave
Opcional. Identifica la subclave que se va a definir. Tiene el formato clave1\clave2\clave3.... Este parßmetro se puede expresar como una cadena reemplazable. Por ejemplo, podrφa usar %Subclave1%, donde la cadena que sustituye a %Subclave1% se define en la secci≤n Strings del archivo .inf.

nombre-valor
Opcional. Identifica el nombre del valor para la subclave. Para el tipo cadena, si el parßmetro nombre-valor estß vacφo a la izquierda, el valor de la subclave especificado en el parßmetro subclave se establece a una cadena NULL. Tenga en cuenta que el parßmetro nombre-valor se puede expresar como una cadena reemplazable. Por ejemplo, podrφa usar %NombreVal1%, donde la cadena que sustituye a %NombreVal1% se define en la secci≤n Strings del archivo .inf.

indicador
Opcional. Determina tanto el tipo de valor como si la clave del Registro se reemplaza si ya existe.

valor
Opcional. El valor que se establece. Puede ser una cadena ANSI o un n·mero en notaci≤n hexadecimal y formato de Intel. Cualquier elemento que contenga un valor binario puede superar el mßximo de 128 bytes para la lφnea si se utiliza un carßcter de barra diagonal inversa (\). TambiΘn se puede proporcionar una clave de cadena con el formato %claveCad%. La claveCad debe definirse en la secci≤n Strings del archivo .inf. Para usar un carßcter % en la lφnea, use %%.

Son obligatorios dos campos, como mφnimo; sin embargo, uno puede ser nulo. Por tanto, al utilizar este formato es obligatorio utilizar, como mφnimo, una coma.

Los dos elementos del ejemplo de secci≤n del tipo AddReg siguiente agregan dos nombres de valor al Registro. Tenga en cuenta que %25% se expandirß en la carpeta Windows del equipo.

[MyAppRegEntries]
HKLM,Software\MyApp,ProgramName,,"My Application"
HKLM,Software\MyApp,"Program Location",,"%25%\MyApp.exe"

Secciones Delete Registry (DelReg)

[ secci≤n-del-registry]
cadena-raφz-reg, subclave, [nombre-valor]
[cadena-raφz-reg, subclave, [nombre-valor]]
.
.
Eliminan una subclave o nombre de valor del Registro. El nombre secci≤n-del-registry debe aparecer en un elemento DelReg de una secci≤n Install.

cadena-raφz-reg
Nombre raφz del Registro. Pueden ser uno de los valores siguientes:

HKCR igual que HKEY_CLASSES_ROOT
HKCU igual que HKEY_CURRENT_USER
HKLM igual que HKEY_LOCAL_MACHINE
HKU igual que HKEY_USERS.
HKR significa relativo a la clave pasada en GenInstallEx

subclave
Identifica la subclave que se va a eliminar. Tiene el formato clave1\clave2\clave3... Este parßmetro se puede expresar como una cadena reemplazable. Por ejemplo, podrφa usar %Subclave1%, donde la cadena que sustituye a %Subclave1% se define en la secci≤n Strings del archivo .inf.

nombre-valor
Opcional. Identifica el nombre del valor para la subclave. Tenga en cuenta que el parßmetro nombre-valor se puede expresar como una cadena reemplazable. Por ejemplo, podrφa usar %NombreVal1%, donde la cadena que sustituye a %NombreVal1% se define en la secci≤n Strings del archivo .inf.

Este tipo de secci≤n puede contener cualquier n·mero de elementos. Cada elemento elimina un subclave o nombre de valor del Registro.

Secciones Ini File to Registry (Ini2Reg)

[ secci≤n-ini-to-registry]
archivo-ini, secci≤n-ini, [clave-ini], cadena-raφz-reg, subclave[,indicadores]
.
.
Mueven lφneas o secciones de un archivo .ini al Registro y crean o reemplazan una entrada del Registro debajo de la clave dada en el Registro. El nombre de secci≤n secci≤n-ini-to-registry debe aparecer en un elemento Ini2Reg de una secci≤n Install del archivo .inf.

archivo-ini
Nombre del archivo .ini que contiene la clave que se va a copiar. Para obtener mßs informaci≤n acerca de c≤mo especificar el nombre del archivo .ini, consulte los comentarios del tema "Referencia" acerca de la secci≤n Update .ini File.

secci≤n-ini
Nombre de la secci≤n del archivo .ini que contiene la clave que se va a copiar.

clave-ini
Nombre de la clave del archivo .ini que se va a copiar al Registro. Si clave-ini estß vacφo, toda la secci≤n se transfiere a la clave del Registro especificada.

cadena-raφz-reg
Nombre raφz del Registro. Pueden ser uno de los valores siguientes:

HKCR igual que HKEY_CLASSES_ROOT
HKCU igual que HKEY_CURRENT_USER
HKLM igual que HKEY_LOCAL_MACHINE
HKU igual que HKEY_USERS.
HKR significa relativo a la clave pasada en GenInstallEx

subclave
Identifica la subclave que va a recibir el valor. Tiene el formato clave1\clave2\clave3...

indicadores
Indica si se debe eliminar la clave .ini despuΘs de transferirse al Registro y si se debe sobrescribir el valor en el Registro si ya existe la clave del Registro. Pueden ser uno de los valores siguientes:

[Windows]
CursorBlinkRate=15

Si debajo de Control Panel\Desktop no hay una subclave CursorBlinkRate, el elemento siguiente de la secci≤n Ini File to Registry crea la subclave, establece el valor de la subclave a 15 y no cambia la lφnea original de WIN..ini:

win.ini,Windows,CursorBlinkRate,HKCU,"Control Panel\Desktop"

Si la subclave ya existe, el elemento del archivo .inf establece el valor de la subclave a 15 y no cambia la lφnea original de WIN..ini.

Secciones Update Config.sys (UpdateCfgSys)

[ secci≤n-update-config]
Buffers=n·mero-b·feres-dos-vßlido
DelKey=clave
DevAddDev=nombre-controlador,palabraClaveConfig[,indicador][,cadena-parßm]
DevDelete=nombre-controlador-dispositivo
DevRename=nombre-dispositivo-actual,nombre-dispositivo-nuevo
Files=n·mero-archivos-dos-vßlido
PrefixPath=ldid[,ldid]
RemKey=clave
Stacks=valores-pilas-dos

Proporcionan comandos para agregar, eliminar o cambiar el nombre de comandos en el archivo Config.sys. El nombre de la secci≤n, nombre-secci≤n-update-ini, debe aparecer en el elemento UpdateInis de una secci≤n Install en el archivo .inf.

No todos los tipos de elemento que se muestran en la sintaxis anterior son necesarios u obligatorios. Una secci≤n Update Config.sys puede contener tantos elementos DevRename, DevDelete, DevAddDev, DelKey y RemKey como se necesiten, pero los elementos Buffers, Files y Stacks s≤lo se pueden usar una vez en una secci≤n. Cuando se procesa una secci≤n Update Config.sys, el instalador procesa todos los elementos DevRenames en primer lugar, todos los elementos DevDelete despuΘs y todos los elementos DevAddDev al final. La sintaxis y significado de cada uno de los tipos de elemento que se pueden usar en una secci≤n Update Config.sys se proporcionan posteriormente en este tema.

Elemento Buffers

Buffers=n·mero-b·feres-dos-vßlido
Establece el n·mero de b·feres de archivo. Al igual que con el elemento Stacks, el instalador compara el valor existente con el propuesto y establece siempre el n·mero de b·feres al mayor de los dos valores.

n·mero-b·feres-dos-vßlido
Un n·mero de b·feres MS-DOS vßlido.

Elemento DelKey

DelKey=clave
Ocasiona que el comando Config.sys con la clave especificada se comente dentro del archivo Config.sys. Por ejemplo, el elemento del archivo .inf siguiente:

DelKey=Break

ocasionarφa que un comando Break=on se comentara dentro del archivo Config.sys.

El elemento DelKey tiene el mismo efecto que el elemento RemKey . Puede haber varios elementos DelKey y RemKey en una secci≤n de un archivo .inf.

clave
La clave del comando de Config.sys que se va a comentar.

Elemento DevAddDev

DevAddDev=nombre-controlador,palabraClaveConfig[,indicador][,cadena-parßm]
Agrega un comando device o install al archivo CONFIG.SYS.

nombre-controlador
Nombre del archivo ejecutable o controlador que agregar. El instalador valida la extensi≤n del nombre de archivo y comprueba que sea. sys o .exe.

palabraClaveConfig
Nombre del comando. Puede ser device o install.

indicador
Indicador de posici≤n opcional. Si es 0, el comando se coloca al final del archivo. Si es 1, se coloca al principio. Si no se proporciona ning·n indicador, se utiliza 0 como opci≤n predeterminada.

cadena-parßm
Parßmetros de comando opcionales. Deben ser vßlidos para el controlador de dispositivo o archivo ejecutable especificados.

Elemento DevDelete

DevDelete=nombre-controlador-dispositivo
Elimina las lφneas que contengan el nombre de archivo especificado del archivo Config.sys.

nombre-controlador-dispositivo
Nombre de un archivo o controlador de dispositivo. El instalador busca en el archivo Config.sys el nombre y elimina cualquier lφnea que lo contenga. Ya que MS-DOS no permite extensiones de nombre de archivo implφcitas en Config.sys, cada nombre-controlador-dispositivo debe especificar la extensi≤n del nombre de archivo de forma explφcita.

En el ejemplo siguiente, el elemento DevDelete de la secci≤n Update Config.sys elimina las lφneas 1 y 3, y deja la lφnea 2 del archivo Config.sys de ejemplo:

DevDelete=filename.sys
;; lφneas en Config.sys
Device=Filename.sys ;; lφnea n║1
Install=Filename.exe ;; lφnea n║2
Device=Filename.sys /d:b800 /I:3 ;; lφnea n║3

Elemento DevRename

DevRename=nombre-dispositivo-actual,nombre-dispositivo-nuevo
Cambia el nombre de un controlador de dispositivo del archivo Config.sys.

nombre-dispositivo-actual
Nombre del controlador de dispositivo o archivo ejecutable cuyo nombre se va a cambiar. El instalador busca el nombre en la parte de la derecha de un comando device o install en el archivo Config.sys.

nombre-dispositivo-nuevo
Nombre nuevo para el controlador o archivo ejecutable.

Elemento Files

Files=n·mero-archivos-dos-vßlido
Establece el n·mero mßximo de archivos abiertos en el archivo Config.sys. Al igual que con el elemento Stacks, el instalador compara el valor existente con el propuesto y establece siempre el n·mero de b·feres al mayor de los dos valores.

n·mero-archivos-dos-vßlido
N·mero de archivos de MS-DOS vßlido.

Elemento PrefixPath

PrefixPath=ldid[,ldid]...
Anexa al comando path la ruta de acceso asociada al LDID dado.

ldid
Puede ser cualquiera de los valores LDID predefinidos o un valor nuevo definido en el archivo .inf. Para obtener una definici≤n de los valores LDID predefinidos, consulte el tema "Referencia" acerca de la secci≤n DestinationDirs.

Elemento RemKey

RemKey=clave
Ocasiona que el comando de Config.sys con la clave especificada se comente en el archivo Config.sys. Por ejemplo, el elemento del archivo .inf siguiente:

RemKey=Break

ocasionarφa que un comando Break=on se comentara dentro del archivo Config.sys.

El elemento RemKey tiene el mismo efecto que el elemento DelKey . Puede haber varios elementos RemKey y DelKey en una secci≤n del archivo .inf.

clave
La clave del comando de Config.sys que se va a comentar.

Elemento Stacks

Stacks=valores-pilas-dos
Establece el n·mero y tama±o de las pilas del archivo Config.sys. El instalador compara el valor existente con el propuesto y establece siempre el mayor de los dos. Por ejemplo, si Config.sys contiene stacks=9,218 y el archivo .inf contiene stacks=5,256, el instalador establece el nuevo valor a stacks=9,256.

n·mero-pilas-dos-vßlido
Un n·mero de pilas de MS-DOS vßlido.

Secciones Update Autoexec.bat (UpdateAutoBat)

[ secci≤n-update-autoexec]
CmdAdd=nombre-comando[,parßmetros-comando]
CmdDelete=nombre-comando
PrefixPath=ldid[,ldid]
RemOldPath=ldid[,ldid]
TmpDir=ldid[,subdir]
UnSet=nombre-variable-entorno

Proporcionan comandos para tratar lφneas del archivo Autoexec.bat. El nombre de la secci≤n, nombre-secci≤n-update-ini, debe aparecer en el elemento UpdateInis de una secci≤n Install en el archivo .inf.

No todos los tipos de elemento mostrados en la sintaxis anterior son necesarios u obligatorios en una secci≤n Update Autoexec.bat. La secci≤n puede contener tantos elementos CmdAdd, CmdDelete y UnSet como se necesiten pero, en un archivo .inf, s≤lo se puede usar un elemento PrefixPath, RemOldPath y TmpDir. La sintaxis y significado de cada uno de los tipos de elemento se describen posteriormente en este tema.

El instalador procesa todos los elementos CmdDelete antes de los elementos CmdAdd.

CmdAdd Item

CmdAdd =nombre-comando[,"parßmetros-comando"]
Agrega el comando y los parßmetros de comandos opcionales especificados al final del archivo Autoexec.bat.

nombre-comando
Nombre de un archivo ejecutable, con o sin extensi≤n. Si el nombre de archivo se define tambiΘn en las secciones SourceDisksFiles y DestinationDirs del archivo .inf, el instalador agrega la ruta de acceso correspondiente al nombre de archivo antes de escribirla en el archivo Autoexec.bat.

parßmetros-comando
Cadena incluida entre comillas tipogrßficas o una cadena reemplazable como %Cadena1% o %Miparßmetro%, donde las cadenas que sustituyen a %Cadena1% y %Miparßmetro% se definen en la secci≤n Strings del archivo .inf. El instalador anexa la cadena a nombre-comando antes de anexar la lφnea al final del archivo Autoexec.bat. El formato de esta lφnea depende de los requisitos de lφnea de comando del archivo ejecutable dado.

Elemento CmdDelete

CmdDelete=nombre-comando
Elimina las lφneas de Autoexec.bat que incluyan el nombre de comando especificado. El instalador busca y elimina cualquier aparici≤n del nombre especificado que tenga la extensi≤n de nombre de archivo .exe, .com y .bat.

nombre-comando
Nombre de un archivo ejecutable sin extensi≤n.

Elemento PrefixPath

PrefixPath=ldid[,ldid]...
Anexa al comando path la ruta de acceso asociada al LDID dado.

ldid
Puede ser cualquiera de los valores LDID predefinidos o un valor nuevo definido en el archivo .inf. Para obtener una definici≤n de los valores LDID predefinidos, consulte el tema "Referencia" acerca de la secci≤n DestinationDirs.

Elemento RemOldPath

RemOldPath=ldid[,ldid]
Quita del comando path la ruta de acceso asociada al LDID especificado. Por ejemplo, si el usuario instala una versi≤n nueva de Windows en C:\Newwin y tiene una copia anterior de Windows en C:\Windows, el elemento del archivo .inf siguiente quita C:\Windows de la variable de entorno path:

RemOldPath=10
ldid
Puede ser cualquiera de los valores LDID predefinidos o un valor nuevo definido en el archivo .inf. Para obtener una definici≤n de los valores LDID predefinidos, consulte el tema "Referencia" acerca de la secci≤n DestinationDirs.

Elemento TmpDir

TmpDir=ldid[,subdir]
Crea una carpeta temporal dentro de la carpeta especificada en el LDID, si no existe.

ldid
Puede ser cualquiera de los valores LDID predefinidos o un valor nuevo definido en el archivo .inf. Para obtener una definici≤n de los valores LDID predefinidos, consulte el tema "Referencia" acerca de la secci≤n DestinationDirs.

subdir
Nombre de la ruta de acceso. Si ldid\subdir no existe todavφa, se crea.

Elemento UnSet

UnSet=nombre-variable-entorno
Quita cualquier comando set del archivo Autoexec.bat que incluya el nombre de la variable de entorno especificada.

nombre-variable-entorno
Nombre de una variable de entorno.

Secci≤n DestinationDirs

[DestinationDirs]
secci≤n-lista-archivos =ldid[, subdir ]
.
.
[DefaultDestDir=ldid[, subdir ]]

La secci≤n DestinationDirs define los directorios de destino para las operaciones especificadas en archivo-lista secci≤n, que son las secciones CopyFiles, RenFiles o DelFiles. Opcionalmente, se puede especificar una carpeta de destino predeterminada para las secciones CopyFiles, RenFiles o DelFiles en el archivo .inf que no se nombre explφcitamente en la secci≤n DestinationDirs.

secci≤n-lista-archivo
Nombre de una secci≤n CopyFiles, RenFiles o DelFiles. Se puede hacer referencia a este nombre en un elemento Copyfiles, RenFiles o DelFiles de una secci≤n Install.

ldid
Identificador de disco l≤gico (LDID). Pueden ser uno de los valores siguientes:

subdir
Nombre de la carpeta dentro de la carpeta nombrada por el LDID como carpeta de destino.

El elemento opcional DefaultDestDir proporciona un destino predeterminado para los elementos CopyFiles que usen la notaci≤n de copia directa (@nombre de archivo) o las secciones CopyFiles, RenFiles o DelFiles no especificadas en la secci≤n DestinationDirs . Si en una secci≤n DestinationDirs no se utiliza DefaultDestDir, la carpeta predeterminada se establece a LDID_WIN.

En el ejemplo siguiente se establece la carpeta de destino para la secci≤n MoveMiniPort a Windows\Iosybsys y se establece como carpeta predeterminada para otras secciones la carpeta Bin en la unidad de inicio:

[DestinationDirs]
MoveMiniPort=12 ; Destino para la secci≤n MoveMiniPort es
; windows\iosubsys
DefaultDestDirs=30,bin ; Copias directas van a boot:\bin

Secci≤n SourceDisksNames

[SourceDisksNames]
ordinal-disco="descripci≤n-disco",etiqueta-disco,n·mero-serie-disco
.
.
Identifica y da nombre a los discos que contienen los archivos de origen para las operaciones de copia y cambio de nombre de archivos.

ordinal-disco
Un n·mero exclusivo que identifica un disco de origen. Si hay mßs de un disco de origen, cada uno debe tener un n·mero ordinal exclusivo.

descripci≤n-disco
Una cadena o clave de cadenas que describe el contenido o prop≤sito del disco. El instalador muestra esta cadena al usuario para identificar el disco. La descripci≤n se incluye entre comillas tipogrßficas.

etiqueta-disco
Etiqueta de volumen del disco de origen que se define cuando se formatea el disco.

n·mero-serie-disco
No se utiliza. El valor debe ser 0.

En este ejemplo se identifica un disco de origen. La descripci≤n del disco se proporciona como una clave de cadenas:

[SourceDisksNames]
55 = %ID1%, Instd1, 0

[Strings]
ID1="Mi disco de instalaci≤n de la aplicaci≤n 1"

[SourceDisksFiles]
nombre archivo=n·mero-disco[,subdir] [,tama±o-archivo]
.
.
color=#000000Da nombre a los archivos de origen durante la instalaci≤n e identifica los discos de origen que contienen los archivos.

color=#000000nombre archivo
color=#000000Nombre del archivo en el disco de origen.

n·mero-disco
color=#000000N·mero ordinal del disco de origen que contiene el archivo. Este n·mero ordinal se debe definir en la secci≤n SourceDisksNames y debe tener un valor mayor o igual que 1 (cero no es un valor de parßmetro n·mero-disco vßlido).

subdir
Parßmetro opcional que especifica la subcarpeta en el disco de origen donde reside el archivo. Si este parßmetro no se usa, la carpeta raφz del disco de origen es la predeterminada.

tama±o-archivo Parßmetro opcional que especifica el tama±o del archivo, en bytes.

color=#000000El ejemplo de secci≤n SourceDisksFiles siguiente identifica un ·nico archivo de origen, SRS01.386, en el disco que tiene el n·mero ordinal 1:

[SourceDisksFiles]
SRS01.386 = 1

Secci≤n Strings

[Strings]
clave-cadenas=valor
.
.
Define una o varias claves de cadenas. Una clave de cadenas es un nombre que representa una cadena de caracteres imprimibles. Aunque la secci≤n Strings generalmente es la ·ltima del archivo .inf, una clave de cadenas definida en esta secci≤n puede usarse en cualquier parte del archivo .inf en la que se usarφa la cadena correspondiente. El instalador sustituye la clave de cadenas por la cadena especificada y la usa en el procesamiento posterior. Debe incluir una clave de cadenas entre signos de porcentaje (%).

clave-cadenas
Nombre exclusivo que se compone de letras y dφgitos.

valor
Cadena que se compone de letras, dφgitos u otros caracteres imprimibles. Debe incluirse entre dobles comillas tipogrßficas si la clave de cadenas correspondiente se utiliza en un tipo de elemento que las requiere.

La secci≤n Strings facilita la conversi≤n en mercados internacionales al colocar todas las cadenas que se pueden mostrar en la interfaz de usuario cuando el archivo .inf se usa en una ·nica secci≤n del archivo .inf. Las claves de cadenas se deben usar siempre que sea posible.

En el ejemplo siguiente se muestra la secci≤n Strings para un archivo .inf de ejemplo.

[Strings]
String0="Mi aplicaci≤n"
String1="Archivo LΘame de Mi aplicaci≤n"
String2="Adaptador CX2590 SCSI"

Secci≤n Opcional Components

[Optional Components]
nombre-secci≤n-install
[nombre-secci≤n-install]
.
.
Enumera las secciones Install que se muestran cuando el usuario hace clic en el icono Agregar o quitar programas del Panel de control, hace clic en la ficha Instalaci≤n de Windows y, a continuaci≤n, hace clic en el bot≤n Utilizar disco. La secci≤n Install se presenta como casillas de verificaci≤n en la lista.

Tenga en cuenta que la secci≤n Opcional Components se omite cuando se ejecuta un archivo .inf al hacer clic con el bot≤n secundario del mouse (rat≤n) en el archivo y seleccionar el verbo "install". Al ejecutar un archivo .inf de esta forma, se ejecuta la secci≤n [DefaultInstall]. La secci≤n Optional Components tambiΘn se omite si el archivo .inf se estß ejecutando a travΘs del punto de entrada InstallHinfSection de Setupx.dll. Cuando se ejecuta un archivo .inf a travΘs del punto de entrada SETUPX, se ejecuta la secci≤n Install especificada en el parßmetro al punto de entrada.

Las secciones Install siguen el mismo formato que se describi≤ anteriormente y las claves adicionales siguientes se pueden agregar a la secci≤n Install para dirigir la interfaz en el cuadro de dißlogo "Utilizar disco":

OptionDesc=descripci≤n-opci≤n
Sugerencia=descripci≤n-sugerencia
InstallDefault=0 | 1 ; Si se instala este componente de forma predeterminada. 1=Sφ, 0=No.
IconIndex=φndice-icono
Parent= nombre-secci≤n-install
Needs=nombre-secci≤n-install, [nombre-secci≤n-install]
Include=archivo-inf, [archivo-inf]

descripci≤n-opci≤n
Cadena que se utiliza como nombre del componente en el cuadro de lista. El parßmetro descripci≤n-opci≤n puede ser %Cadena1%, donde la cadena que sustituye a %Cadena1% se define en la secci≤n Strings del archivo .inf.

descripci≤n-sugerencia
Cadena que se muestra en el cuadro "descripci≤n" cuando el componente se selecciona en el cuadro de lista. El parßmetro descripci≤n-sugerencia tiene un lφmite de 255 caracteres y puede ser %Cadena1%, donde la cadena que sustituye a %Cadena1% se define en la secci≤n Strings del archivo .inf.

φndice-icono
Valor numΘrico que determina el miniicono que se muestra junto al nombre del componente. Son valores vßlidos:
0 Equipo (base y pantalla)
1 Chip de circuitos integrados
2 Pantalla
3 Cables de red
4 Indicador de Windows
5 Mouse
6 Teclado (3 teclas)
7 TelΘfono
8 Altavoz
9 Discos duros
10 Conector comm.
11 Rombo (valor predeterminado)
12 Casilla de verificaci≤n activada
13 Casilla de verificaci≤n desactivada
14 Impresora
15 Tarjeta de red
16 Igual que 0
17 Igual que 0 con una mano
18 Desconocido (signo de interrogaci≤n)
19 Atwork
20 Casilla de verificaci≤n atenuada
21 Acceso telef≤nico a redes
22 Conexi≤n directa por cable
23 Maletφn
24 Exchange
25 Marca parcial
26 Grupo Accesorios
27 Grupo Multimedia
28 Vista rßpida
29 MSN
30 Calculadora
31 Desfragmentador
32 Documento genΘrico
33 DriveSpace
34 Solitario
35 HyperTerminal
36 Empaquetador de objetos
37 Paint
38 Protector de pantalla
39 WordPad
40 Visor del Portapapeles
41 Accessibilidad
42 Copia de seguridad
43 Documento de mapa de bits
44 Mapa de caracteres
45 Punteros de mouse
46 Monitor de red
47 Marcador telef≤nico
48 Monitor de sistema
49 Libro de Ayuda
50 Globo (international settings)
51 Compresi≤n de audio
52 Reproductor de CD
53 Reproductor multimedia
54 Esquema de sonidos
55 Clip de vφdeo
56 Compresi≤n de vφdeo
57 Control de volumen
58 Musica - esquema de sonidos
59 Jungla - esquema de sonidos
60 Robotz - esquema de sonidos
61 Utopφa - esquema de sonidos

Parent
El cuadro de lista mostrado en la interfaz de componentes opcionales puede contener niveles secundarios. Si el componente opcional es secundario, la palabra clave Parent= define la secci≤n Install principal.

Needs
Si este componente tiene dependencias en otros componentes, este elemento define las secciones Install que este componente necesita. Si el componente se selecciona, se advertirß al usuario que el componente necesita los componentes descritos en las secciones Install enumeradas en Needs= lφnea.

Tenga en cuenta que las secciones Install enumeradas en Needs= lφnea deben estar en el mismo archivo .inf. Sin embargo, si los componentes dependientes de otros archivos .inf se enumeran en la Needs= lφnea, los archivos .inf deben especificarse en el Include= lφnea.

Include
El elemento Include permite especificar archivos .inf que el programa de instalaci≤n tambiΘn debe cargar en la memoria cuando carga el archivo .inf, ya que estos archivos .inf contienen secciones que se deben ejecutar ademßs de las secciones Install del archivo .inf. El elemento Needs especifica los nombres de las secciones que usted tiene intenci≤n de ejecutar en el archivo o archivos .inf incluidos.

En el ejemplo siguiente se definen dos secciones Install con componentes opcionales; cada secci≤n usa las entradas adicionales para especificar dependencias y elementos de la interfaz:

[Opcional Components]
InstallMyToys
InstallGames

[InstallMyToys]
OptionDesc=%Toys_DESC%
Tip=%Tomytoysys_TIP%
IconIndex=35 ;Mini-icono telΘfono para dißlogos
Parent=MailApps
Needs=MSMAIL, MAPI, MicrosoftNetwork
Include=mos.inf, msmail.inf
CopyFiles=MyToysFiles
UpdateInis=MyToysLinks
AddReg=MyToysRegItems

[InstallOtherApps]
OptionDesc=%Other_DESC%
Tip=%Other_TIP%
IconIndex=4 ;mini-icono windows para dißlogos
CopyFiles=OtherFiles
UpdateInis=OtherLinks
AddReg=OtherRegItems

[Strings]
Toys_DESC="Programas Correo"
Toys_TIP="Programas adicionales para enviar y organizar correo"
Other_DESC="Otros programas ·tiles"
Other_TIP="Calculadora, revisor de disco y controlador de rendimiento"

Temas relacionados