Section INF SourceDisksNames
Une section SourceDisksNames identifie les disques de distribution ou les disques CD-ROM qui contiennent les fichiers sources à transférer sur l’ordinateur cible pendant l’installation.
[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)
...
Entrées
diskid
Spécifie un entier non négatif, au format décimal, qui identifie un disque source. Cette valeur ne peut pas nécessiter plus de 4 octets de stockage. S’il existe plusieurs disques sources pour la distribution, chaque entrée diskid de cette section doit avoir une valeur unique, telle que 1, 2, 3, etc.
description du disque
Spécifie un jeton %strkey% ou une «chaîne quoted» qui décrit le contenu et/ou l’objectif du disque identifié par diskid. Le programme d’installation peut afficher la valeur de cette chaîne à l’utilisateur final pendant l’installation, par exemple, pour identifier un disque source à insérer dans un lecteur à une étape particulière du processus d’installation.
Chaque spécification %strkey% de cette section doit être définie dans la section Strings de l’INF. Toute description de disque qui n’est pas un jeton %strkey% est une chaîne visible par l’utilisateur qui doit être délimitée par des guillemets doubles (« ) si elle a des espaces de début ou de fin.
tag-or-cab-file
Cette valeur facultative spécifie le nom d’un fichier de balise ou d’un fichier d’armoire (.cab) fourni sur le disque de distribution, soit dans la racine d’installation , soit dans le sous-répertoire spécifié par chemin d’accès, le cas échéant. La valeur doit spécifier uniquement le nom et l’extension du fichier, et non aucun répertoire ou sous-répertoire.
Windows utilise un fichier de balise pour vérifier que l’utilisateur a inséré le disque d’installation correct. Les fichiers de balise sont requis pour les supports amovibles et sont facultatifs pour les supports fixes.
Si Windows ne trouve pas les fichiers d’installation par nom sur le support d’installation, et si tag-or-cab-file a l’extension .cab, Windows l’utilise comme nom d’un fichier d’armoire qui contient les fichiers d’installation.
S’il s’agit d’un . L’extension cab est spécifiée. Windows traite le fichier à la fois comme un fichier de balise et un fichier d’armoire, comme expliqué dans la section Remarques suivante.
Pour Windows XP et les versions ultérieures de Windows, consultez également les indicateurs et les valeurs d’entrée de fichier de balise .
Inutilisés
Cette entrée n’est plus prise en charge pour Windows 2000 et versions ultérieures de Windows.
path
Cette valeur facultative spécifie le chemin du répertoire sur le disque de distribution qui contient les fichiers sources. Le chemin est relatif à la racine d’installation et est exprimé en tant que \dirname1\dirname2..., et ainsi de suite. Si cette valeur est omise dans une entrée, les fichiers sont supposés se trouver à la racine d’installation du disque de distribution.
Vous pouvez utiliser une section INF SourceDisksFiles pour spécifier des sous-répertoires, relatifs à un répertoire de chemin d’accès donné, qui contiennent des fichiers sources. Toutefois, les fichiers de balise et le fichier d’armoire doivent résider soit dans le répertoire de chemin d’accès donné, soit dans la racine d’installation.
flags
À compter de Windows XP, la définition de ce paramètre sur 0x10 force Windows à utiliser tag-or-cab-file comme nom de fichier d’armoire et à utiliser tag-file comme nom de fichier de balise. Sinon, les indicateurs sont à usage interne uniquement.
tag-file
À compter de Windows XP, si les indicateurs sont définis sur 0x10, cette valeur facultative spécifie le nom d’un fichier d’étiquettes fourni sur le support de distribution, soit à la racine de l’installation , soit dans le sous-répertoire spécifié par chemin d’accès. La valeur doit spécifier le nom de fichier et l’extension sans informations de chemin d’accès. Pour plus d’informations, consultez la section Remarques.
Remarques
Une section SourceDisksNames peut avoir n’importe quel nombre d’entrées, une pour chaque disque de distribution. Tout INF avec une section SourceDisksNames doit également avoir une section INF SourceDisksFiles. (Par convention, les sections SourceDisksNames et SourceDisksFiles suivent la section Version INF.)
Ces sections n’apparaissent jamais dans les fichiers INF fournis par le système. Au lieu de cela, les fichiers INF fournis par le système spécifient des entrées LayoutFile dans leurs sections Version .
Les entrées d’une section SourceDisksNames peuvent avoir l’un des deux formats, dont l’un est pris en charge uniquement dans Windows XP et les versions ultérieures de Windows.
Dans le premier format, le paramètre tag-or-cab-file peut spécifier un fichier de balise ou un fichier d’armoire. Lorsque vous rencontrez ce format, Windows utilise l’algorithme suivant :
Traitez la valeur tag-or-cab-file comme un nom de fichier de balise et recherchez le fichier sur le support d’installation. Si le support est amovible et que le fichier de balise est introuvable, invitez l’utilisateur à indiquer le support approprié. Si le support est résolu et que ni le fichier de balise ni le premier fichier à installer ne sont trouvés, demandez à l’utilisateur d’indiquer le support approprié.
Essayez de copier les fichiers d’installation directement à partir du support.
Traitez la valeur tag-or-cab-file comme un fichier .cab et recherchez le fichier.
Essayez de copier les fichiers d’installation à partir du fichier .cab .
Demandez à l’utilisateur de spécifier les fichiers introuvables.
Le deuxième format est pris en charge dans Windows XP et les versions ultérieures de Windows. Avec ce format, vous pouvez utiliser les entrées tag-or-cab-file, flags et tag-file pour spécifier à la fois un fichier .cab et un fichier de balise. Lorsqu’il rencontre ce format, Windows utilise l’algorithme suivant :
Si le support d’installation est amovible, recherchez un fichier de balise qui correspond au nom de fichier spécifié par tag-file. Si le fichier est introuvable, demandez à l’utilisateur d’indiquer le support approprié. Si le support est résolu, recherchez le fichier d’étiquettes ou le fichier d’armoire. Si aucun fichier n’est trouvé, demandez à l’utilisateur d’indiquer le support approprié.
Essayez de copier les fichiers d’installation à partir du fichier .cab spécifié par tag-or-cab-file.
Demandez à l’utilisateur de spécifier les fichiers introuvables.
Pour l’un ou l’autre format, vous devez fournir un fichier d’étiquettes différent, avec un nom de fichier différent, pour chaque version des fichiers de pilote.
Pour prendre en charge la distribution de fichiers pilotes sur plusieurs architectures système, vous pouvez spécifier une section SourceDisksNames spécifique à l’architecture en ajoutant une extension d’architecture .x86, .ia64, .amd64 ou une autre extension d’architecture à SourceDisksNames.
N’oubliez pas que, contrairement à d’autres sections telles qu’une section DDInstall , les extensions de plateforme d’une section SourceDisksNames ne sont pas .ntx86, .ntia64, .ntamd64, etc. Par exemple, pour spécifier une section de noms de disque source pour un système x86, utilisez une section SourceDisksNames.x86 , et non une section SourceDisksNames.ntx86 . De même, utilisez une section SourceDisksNames.ia64 pour spécifier un système Itanium et une section SourceDisksNames.amd64 pour spécifier un système x64.
Pendant l’installation, les fonctions SetupAPI recherchent des sections SourceDisksNames spécifiques à l’architecture avant d’utiliser la section générique. Par exemple, si, lors de l’installation sur une plateforme x86, un fichier INF fait référence au disque « 2 », les fonctions d’installation de l’appareil recherchent une entrée pour le disque « 2 » dans SourceDisksNames.x86 avant de rechercher dans SourceDisksNames.
Les fonctions d’installation d’appareil utilisent sourceDisksNames et SourceDisksNames.sections d’architecture qui se trouvent dans le même fichier INF que la section SourceDisksFiles appropriée.
Exemples
Dans l’exemple suivant, le fichier write.exe est le même pour toutes les plateformes Windows et se trouve dans le sous-répertoire \common , sous la racine d’installation, sur un disque de distribution CD-ROM. Le fichiercmd.exe est un fichier spécifique à la plateforme qui est utilisé uniquement sur les plateformes 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
L’exemple suivant utilise des entrées qui contiennent des spécifications distinctes pour les fichiers .tag et les fichiers.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"