ABSCHNITT "INF SourceDisksNames"

Ein Abschnitt "SourceDisksNames" identifiziert die Verteilungsdatenträger oder CD-ROM Datenträger, die die Quelldateien enthalten, die während der Installation auf den Zielcomputer übertragen werden sollen.

[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)
...

Einträge

diskid
Gibt eine nicht-negative ganze Zahl im Dezimalformat an, die einen Quelldatenträger identifiziert. Dieser Wert kann nicht mehr als 4 Byte Speicherplatz erfordern. Wenn mehrere Quelldatenträger für die Verteilung vorhanden sind, muss jeder Diskid-Eintrag in diesem Abschnitt einen eindeutigen Wert aufweisen, z. B. 1, 2, 3 usw.

Datenträgerbeschreibung
Gibt ein %strkey -%-Token oder eine "an zitierte Zeichenfolge" an, die den Inhalt und/oder den Zweck des Datenträgers beschreibt, der von diskid identifiziert wird. Das Installationsprogramm kann den Wert dieser Zeichenfolge während der Installation für den Endbenutzer anzeigen, um z. B. einen Quelldatenträger zu identifizieren, der in eine bestimmte Phase des Installationsvorgangs in ein Laufwerk eingefügt werden soll.

Jede %strkey% Spezifikation in diesem Abschnitt muss im Abschnitt " Strings " des INF definiert werden. Jede Datenträgerbeschreibung , die kein %strkey% Token ist, ist eine vom Benutzer sichtbare Zeichenfolge, die durch doppelte Anführungszeichen (") getrennt werden muss, wenn es führende oder nachfolgende Leerzeichen enthält.

tag-or-cab-file
Dieser optionale Wert gibt den Namen einer Tagdatei oder einer CAB-Datei (.cab) an, die auf dem Verteilungsdatenträger bereitgestellt wird, entweder im Installationsstamm oder im Unterverzeichnis, das nach Pfad angegeben ist, falls vorhanden. Der Wert sollte nur den Dateinamen und die Erweiterung angeben, nicht ein Verzeichnis oder Unterverzeichnis.

Windows verwendet eine Tagdatei, um zu überprüfen, ob der Benutzer den richtigen Installationsdatenträger eingefügt hat. Tagdateien sind für Wechselmedien erforderlich und sind optional für Feste Medien.

Wenn Windows keine Installationsdateien anhand des Namens auf dem Installationsmedium finden kann und die Erweiterung tag-or-cab-datei vorhanden ist.cab, Windows verwendet sie als Name einer CAB-Datei, die die Installationsdateien enthält.

Wenn ein . cab extension is specified, Windows treats the file as both a tag file and a cabinet file, as specified in the following Remarks section.

Informationen zu Windows XP und höheren Versionen von Windows finden Sie auch in den Flags und Tag-Datei-Eintragswerten.

unbenutzt
Dieser Eintrag wird für Windows 2000 und höhere Versionen von Windows nicht mehr unterstützt.

path
Dieser optionale Wert gibt den Verzeichnispfad auf dem Verteilerdatenträger an, der Quelldateien enthält. Der Pfad ist relativ zum Installationsstamm und wird als \dirname1\dirname2... usw. ausgedrückt. Wenn dieser Wert aus einem Eintrag weggelassen wird, wird davon ausgegangen, dass sich Dateien im Installationsstamm des Verteilungsdatenträgers befinden.

Sie können einen INF SourceDisksFiles-Abschnitt verwenden, um Unterverzeichnisse relativ zu einem bestimmten Pfadverzeichnis anzugeben, die Quelldateien enthalten. Tagdateien und CAB-Dateien müssen sich jedoch entweder im angegebenen Pfadverzeichnis oder im Installationsstamm befinden.

flags
Beginnend mit Windows XP erzwingt das Festlegen auf 0x10, dass Windows tag-or-cab-Datei als Cab-Dateiname verwenden und tag-datei als Tagdateiname verwenden. Andernfalls dienen Flags nur zur internen Verwendung.

Tagdatei
Beginnend mit Windows XP, wenn Flags auf 0x10 festgelegt sind, gibt dieser optionale Wert den Namen einer Tagdatei an, die auf dem Verteilungsmedium bereitgestellt wird, entweder im Installationsstamm oder im Unterverzeichnis, das durch Pfad angegeben ist. Der Wert sollte den Dateinamen und die Erweiterung ohne Pfadinformationen angeben. Weitere Informationen finden Sie im Abschnitt Hinweise.

Bemerkungen

Ein SourceDisksNames-Abschnitt kann eine beliebige Anzahl von Einträgen aufweisen, eine für jeden Verteilungsdatenträger. Jeder INF-Abschnitt mit einem SourceDisksNames-Abschnitt muss auch über einen INF SourceDisksFiles-Abschnitt verfügen. (In der Konvention folgen sourceDisksNames - und SourceDisksFiles-Abschnitte dem ABSCHNITT INF-Version.)

Diese Abschnitte werden nie in vom System bereitgestellten INF-Dateien angezeigt. Stattdessen geben vom System bereitgestellte INF-Dateien LayoutFile-Einträge in ihren Versionsabschnitten an.

Einträge in einem SourceDisksNames-Abschnitt können eines von zwei Formaten aufweisen, von denen eines nur in Windows XP und höheren Versionen von Windows unterstützt wird.

Im ersten Format kann der Parameter "tag-or-cab"-Datei entweder eine Tagdatei oder eine CAB-Datei angeben. Wenn dieses Format auftritt, verwendet Windows den folgenden Algorithmus:

  1. Behandeln Sie den Tag- oder CAB-Dateiwert als Tagdateinamen, und suchen Sie auf dem Installationsmedium nach der Datei. Wenn das Medium wechselbar ist und die Tagdatei nicht gefunden wird, fordern Sie den Benutzer auf, das richtige Medium einzugeben. Wenn das Medium behoben ist und weder die Tagdatei noch die erste zu installierende Datei gefunden werden können, bitten Sie den Benutzer um das richtige Medium.

  2. Versuchen Sie, Installationsdateien direkt vom Medium zu kopieren.

  3. Behandeln Sie den Tag- oder CAB-Dateiwert als .cab Datei, und suchen Sie nach der Datei.

  4. Versuchen Sie, Installationsdateien aus der .cab-Datei zu kopieren.

  5. Fordern Sie den Benutzer auf, dateien nicht gefunden zu haben.

Das zweite Format wird in Windows XP und höheren Versionen von Windows unterstützt. Mit diesem Format können Sie die Tag- oder CAB-Datei- und Tagdateieinträgeverwenden, um sowohl eine .cab-Datei als auch eine Tagdatei anzugeben. Wenn dieses Format auftritt, verwendet Windows den folgenden Algorithmus:

  1. Wenn das Installationsmedium wechselbar ist, suchen Sie nach einer Tagdatei, die dem Dateinamen entspricht, der durch die Tagdatei angegeben wird. Wenn die Datei nicht gefunden wird, fordern Sie den Benutzer auf, das richtige Medium einzugeben. Wenn das Medium behoben ist, suchen Sie entweder nach der Tagdatei oder nach der CAB-Datei. Wenn keine datei gefunden wird, fordern Sie den Benutzer auf, das richtige Medium einzugeben.

  2. Versuchen Sie, Installationsdateien aus der .cab Datei zu kopieren, die durch Tag- oder CAB-Datei angegeben wird.

  3. Fordern Sie den Benutzer auf, dateien nicht gefunden zu haben.

Bei beiden Formaten müssen Sie für jede Version der Treiberdateien eine andere Tagdatei mit einem anderen Dateinamen angeben.

Um die Verteilung von Treiberdateien auf mehreren Systemarchitekturen zu unterstützen, können Sie einen architekturspezifischen SourceDisksNames-Abschnitt angeben, indem Sie eine X86-, IA64-, AMD64- oder andere Architekturerweiterung zu SourceDisksNames hinzufügen.

Beachten Sie, dass im Gegensatz zu anderen Abschnitten wie einem DDInstall-Abschnitt die Plattformerweiterungen für einen SourceDisksNames-Abschnitt nicht ntx86, .ntia64, .ntamd64 usw. sind. Verwenden Sie beispielsweise einen SourceDisksNames.x86-Abschnitt , nicht einen SourceDisksNames.x86-Abschnitt, nicht einen SourceDisksNames.ntx86-Abschnitt , um einen Abschnitt mit Quelldatenträgernamen für ein x86-basiertes System anzugeben. Verwenden Sie in ähnlicher Weise einen SourceDisksNames.ia64-Abschnitt , um ein Itanium-basiertes System und einen SourceDisksNames.amd64-Abschnitt anzugeben, um ein x64-basiertes System anzugeben.

Während der Installation suchen SetupAPI-Funktionen nach architekturspezifischen SourceDisksNames-Abschnitten , bevor Sie den generischen Abschnitt verwenden. Wenn beispielsweise während der Installation auf einer x86-basierten Plattform eine INF-Datei auf den Datenträger "2" verweist, suchen die Geräteinstallationsfunktionen nach einem Eintrag für den Datenträger "2" in SourceDisksNames.x86 , bevor Sie in SourceDisksNames suchen.

Geräteinstallationsfunktionen verwenden die SourceDisksNames und SourceDisksNames.Architekturabschnitte , die sich in derselben INF-Datei wie der relevante Abschnitt "SourceDisksFiles " befinden.

Examples

Im folgenden Beispiel ist die write.exe-Datei für alle Windows Plattformen identisch und befindet sich im Unterverzeichnis "\common" unter dem Installationsstamm auf einem CD-ROM Verteilungsdatenträger. Die cmd.exe Datei ist eine plattformspezifische Datei, die nur auf x86-basierten Plattformen verwendet wird.

[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

Im folgenden Beispiel werden Einträge verwendet, die separate Spezifikationen für TAG-Dateien und .cab Dateien enthalten.

[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"

Siehe auch

DestinationDirs

SourceDisksFiles

Version