Sección INF SourceDisksNames
Una sección SourceDisksNames identifica los discos de distribución o los discos CD-ROM que contienen los archivos de origen que se van a transferir al equipo de destino durante la instalación.
[SourceDisksNames] |
[SourceDisksNames.x86] |
[SourceDisksNames.ia64] | (Windows XP and later versions of Windows)
[SourceDisksNames.amd64] | (Windows XP and later versions of Windows)
[SourceDisksNames.arm] | (Windows 8 and later versions of Windows)
[SourceDisksNames.arm64] (Windows 10 version 1709 and later versions of Windows)
diskid = disk-description[,tag-or-cab-file] |
diskid = disk-description[,[tag-or-cab-file][,[unused][,path]]] |
diskid = disk-description[,[tag-or-cab-file],[unused],[path][,flags]] |
diskid = disk-description[,[tag-or-cab-file],[unused],[path],[flags][,tag-file]] (Windows XP and later versions of Windows)
...
Entradas
diskid
Especifica un entero no negativo, en formato decimal, que identifica un disco de origen. Este valor no puede requerir más de 4 bytes de almacenamiento. Si hay más de un disco de origen para la distribución, cada entrada de diskid de esta sección debe tener un valor único, como 1, 2, 3, etc.
disk-description
Especifica un token %strkey% o una "cadena entre comillas" que describe el contenido o el propósito del disco identificado por diskid. El instalador puede mostrar el valor de esta cadena al usuario final durante la instalación, por ejemplo, para identificar un disco de origen que se va a insertar en una unidad en una fase determinada del proceso de instalación.
Cada especificación %strkey% de esta sección debe definirse en la sección Cadenas de INF. Cualquier descripción del disco que no sea un token %strkey% es una cadena visible para el usuario que se debe delimitar entre comillas dobles (") si tiene espacios iniciales o finales.
tag-or-cab-file
Este valor opcional especifica el nombre de un archivo de etiqueta o archivo de contenedor (.cab) proporcionado en el disco de distribución, ya sea en la raíz de instalación o en el subdirectorio especificado por ruta de acceso, si existe. El valor debe especificar solo el nombre de archivo y la extensión, no ningún directorio o subdirectorio.
Windows usa un archivo de etiqueta para comprobar que el usuario insertó el disco de instalación correcto. Los archivos de etiqueta son necesarios para medios extraíbles y son opcionales para medios fijos.
Si Windows no encuentra los archivos de instalación por nombre en el medio de instalación y si tag-or-cab-file tiene la extensión .Cab, Windows lo usa como nombre de un archivo de gabinete que contiene los archivos de instalación.
Si es . Se especifica la extensión cab , Windows trata el archivo como un archivo de etiqueta y un archivo de gabinete, como se explica en la sección Comentarios siguiente.
Para Windows XP y versiones posteriores de Windows, consulta también las marcas y los valores de entrada de archivo de etiquetas .
unused
Esta entrada ya no es compatible con Windows 2000 y versiones posteriores de Windows.
path
Este valor opcional especifica la ruta de acceso del directorio en el disco de distribución que contiene archivos de origen. La ruta de acceso es relativa a la raíz de instalación y se expresa como \dirname1\dirname2..., etc. Si se omite este valor de una entrada, se supone que los archivos están en la raíz de instalación del disco de distribución.
Puede usar una sección INF SourceDisksFiles para especificar subdirectorios, en relación con un directorio de ruta de acceso determinado, que contenga archivos de origen. Sin embargo, los archivos de etiqueta y el archivo de gabinete deben residir en el directorio de ruta de acceso especificado o en la raíz de instalación.
flags
A partir de Windows XP, establecer esta opción en 0x10 obliga a Windows a usar el archivo tag-or-cab como un nombre de archivo de archivador y para usar el archivo de etiqueta como nombre de archivo de etiqueta. De lo contrario, las marcas son solo para uso interno.
tag-file
A partir de Windows XP, si las marcas se establecen en 0x10, este valor opcional especifica el nombre de un archivo de etiqueta proporcionado en el medio de distribución, ya sea en la raíz de instalación o en el subdirectorio especificado por ruta de acceso. El valor debe especificar el nombre de archivo y la extensión sin información de ruta de acceso. Para más información, vea la sección Comentarios.
Comentarios
Una sección SourceDisksNames puede tener cualquier número de entradas, una para cada disco de distribución. Cualquier INF con una sección SourceDisksNames también debe tener una sección INF SourceDisksFiles. (Por convención, las secciones SourceDisksNames y SourceDisksFiles siguen la sección Versión inf).
Estas secciones nunca aparecen en archivos INF proporcionados por el sistema. En su lugar, los archivos INF proporcionados por el sistema especifican entradas LayoutFile en sus secciones Versión .
Las entradas de una sección SourceDisksNames pueden tener cualquiera de los dos formatos, uno de los cuales solo se admite en Windows XP y versiones posteriores de Windows.
En el primer formato, el parámetro tag-or-cab-file puede especificar un archivo de etiqueta o un archivo de gabinete. Al encontrar este formato, Windows usa el siguiente algoritmo:
Trate el valor de tag-or-cab-file como un nombre de archivo de etiqueta y busque el archivo en el medio de instalación. Si el medio es extraíble y no se encuentra el archivo de etiqueta, solicite al usuario el medio correcto. Si el medio es fijo y no se puede encontrar el archivo de etiqueta ni el primer archivo que se va a instalar, pida al usuario el medio correcto.
Intente copiar archivos de instalación directamente desde el medio.
Trate el valor de tag-or-cab-file como un archivo .cab y busque el archivo.
Intente copiar archivos de instalación desde el archivo .cab .
Solicitar al usuario los archivos que no se encuentran.
El segundo formato es compatible con Windows XP y versiones posteriores de Windows. Con este formato, puede usar las entradas tag-or-cab-file, flags y tag-file para especificar un archivo de.cab y un archivo de etiqueta. Cuando encuentra este formato, Windows usa el siguiente algoritmo:
Si el medio de instalación es extraíble, busque un archivo de etiqueta que coincida con el nombre de archivo especificado por tag-file. Si no se encuentra el archivo, solicite al usuario el medio correcto. Si el medio es fijo, busque el archivo de etiqueta o el archivo de gabinete. Si no se encuentra ninguno de los archivos, solicite al usuario el medio correcto.
Intente copiar los archivos de instalación del archivo de.cab especificado por tag-or-cab-file.
Solicitar al usuario los archivos que no se encuentran.
Para cualquier formato, debe proporcionar un archivo de etiqueta diferente, con un nombre de archivo diferente, para cada versión de los archivos de controlador.
Para admitir la distribución de archivos de controlador en varias arquitecturas del sistema, puede especificar una sección SourceDisksNames específica de la arquitectura agregando una extensión de arquitectura .x86, .ia64, .amd64 u otra extensión de arquitectura a SourceDisksNames.
Tenga en cuenta que, a diferencia de otras secciones, como una sección DDInstall , las extensiones de plataforma para una sección SourceDisksNames no son .ntx86, .ntia64, .ntamd64, etc. Por ejemplo, para especificar una sección de nombres de disco de origen para un sistema basado en x86, use una sección SourceDisksNames.x86 , no una sección SourceDisksNames.ntx86 . Del mismo modo, use una sección SourceDisksNames.ia64 para especificar un sistema basado en Itanium y una sección SourceDisksNames.amd64 para especificar un sistema basado en x64.
Durante la instalación, las funciones SetupAPI buscan secciones SourceDisksNames específicas de la arquitectura antes de usar la sección genérica. Por ejemplo, si, durante la instalación en una plataforma basada en x86, un archivo INF hace referencia al disco "2", las funciones de instalación del dispositivo buscan una entrada para el disco "2" en SourceDisksNames.x86 antes de buscar sourceDisksNames.
Las funciones de instalación de dispositivos usan SourceDisksNames y SourceDisksNames.secciones de arquitectura que se encuentran en el mismo archivo INF que la sección SourceDisksFiles correspondiente.
Ejemplos
En el ejemplo siguiente, el archivo write.exe es el mismo para todas las plataformas Windows y se encuentra en el subdirectorio \common , en la raíz de instalación, en un disco de distribución de CD-ROM. El archivo cmd.exe es un archivo específico de la plataforma que solo se usa en plataformas basadas en x86.
[SourceDisksNames]
1 = "Windows NT CD-ROM",file.tag,,\common
[SourceDisksNames.x86]
2 = "Windows NT CD-ROM",file.tag,,\x86
[SourceDisksFiles]
write.exe = 1
cmd.exe = 2
En el ejemplo siguiente se usan entradas que contienen especificaciones independientes para archivos .tag y archivos.cab .
[SourceDisksNames]
1 = "Dajava","Dajava.cab",,,0x10,"Dajava.tag"
2 = "Osc","Osc.cab",,,0x10,"OSC.tag"
3 = "Win","Win.cab",,,0x10,"Win.tag"
4 = "XMLDSO","XMLDSO.cab",,,0x10,"XMLDSO.tag"
[SourceDisksFiles]
ArrayBvr.class=1
BvrCallback.class=1
BvrsToRun.class=1
choice.osc=2
custom.osc=2
login.osc=2
mwcload.exe=3
mwcloadw.exe=3
mwclw32.dll=3
Atom.class=4
DTD.class=4
Entity.class=4
Entry.class=4
[DestinationDirs]
Test = 13
[DefaultInstall]
CopyFiles = Test
[Test]
ArrayBvr.class
mwcloadw.exe
Entity.class
custom.osc
BvrCallback.class
BvrsToRun.class
choice.osc
login.osc
mwcload.exe
mwclw32.dll
Atom.class
DTD.class
Entry.class
[Strings]
Msft = "Microsoft"