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.

disk-description
Spécifie un jeton %strkey% ou une «chaîne entre guillemets» 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 de% strkey dans cette section doit être définie dans la section Chaînes d’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 (") s’il 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 de fichier, et non aucun répertoire ni sous-répertoire.

Windows utilise un fichier de balise pour vérifier que l’utilisateur a inséré le disque d’installation approprié. Les fichiers d’étiquette sont requis pour les supports amovibles et sont facultatifs pour les supports fixes.

Si Windows ne trouvez pas de fichiers d'installation par nom sur le support d'installation, et si le fichier tag-or-cab-file a l'extension .cab, Windows l’utilise comme nom d’un fichier d’armoire qui contient les fichiers d’installation.

Si un . L’extension cab est spécifiée, Windows traite le fichier comme un fichier de balise et un fichier d’armoire, comme expliqué dans la section Remarques suivante.

Pour Windows XP et versions ultérieures de Windows, consultez également les indicateurs et les valeurs d’entrée de fichier de balise.

inutilisé
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 d’accès au répertoire sur le disque de distribution qui contient des fichiers sources. Le chemin d’accès est relatif à la racine d’installation et est exprimé en tant que \dirname1\dirname2..., et ainsi de suite. Si cette valeur est omise à partir d’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, par rapport à un répertoire de chemin donné, qui contiennent des fichiers sources. Toutefois, les fichiers d’étiquette et le fichier d’armoire doivent résider dans le répertoire de chemin d’accès donné ou dans la racine d’installation.

flags
À compter de Windows XP, la définition de ce paramètre sur 0x10 force Windows à utiliser le fichier tag-or-cab-file comme nom de fichier d’armoire et à utiliser tag-file comme nom de fichier d’étiquette. Dans le cas contraire, les indicateurs sont destinés à une utilisation 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’étiquette fourni sur le support de distribution, soit dans la racine d’installation, soit dans le sous-répertoire spécifié par chemin d’accès. La valeur doit spécifier le nom et l’extension de fichier sans informations de chemin d’accès. Pour plus d’informations, consultez la section Remarques.

Remarks

Une section SourceDisksNames peut avoir un nombre quelconque d’entrées, une pour chaque disque de distribution. Toute 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 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 d’étiquette ou un fichier d’armoire. Lorsque vous rencontrez ce format, Windows utilise l’algorithme suivant :

  1. Traitez la valeur du fichier tag-or-cab-file comme un nom de fichier d’étiquette et recherchez le fichier sur le support d’installation. Si le support est amovible et que le fichier d’étiquettes est introuvable, invitez l’utilisateur à entrer le support approprié. Si le support est résolu et que ni le fichier d’étiquette ni le premier fichier à installer ne sont disponibles, invitez l’utilisateur à entrer le support approprié.

  2. Essayez de copier des fichiers d’installation directement à partir du support.

  3. Traitez la valeur du fichier tag-or-cab-file comme un fichier .cab et recherchez le fichier.

  4. Essayez de copier des fichiers d’installation à partir du fichier .cab .

  5. Invitez l’utilisateur à rechercher les fichiers introuvables.

Le deuxième format est pris en charge dans les versions Windows XP et 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 :

  1. 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, invitez l’utilisateur à entrer 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é, invitez l’utilisateur à entrer le support approprié.

  2. Essayez de copier des fichiers d’installation à partir du fichier .cab spécifié par tag-or-cab-file.

  3. Invitez l’utilisateur à rechercher les fichiers introuvables.

Pour les deux formats, vous devez fournir un fichier d’étiquette différent, avec un nom de fichier différent, pour chaque version des fichiers du pilote.

Pour prendre en charge la distribution de fichiers de 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 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, pendant 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 les noms SourceDisks et SourceDisksNames.sections d’architecture qui se trouvent dans le même fichier INF que la section SourceDisksFiles appropriée.

Examples

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 fichier cmd.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"

Voir aussi

DestinationDirs

SourceDisksFiles

Version