Freigeben über


ABSCHNITT "INF SourceDisksNames"

Im Abschnitt SourceDisksNames werden die Verteilungsdatenträger oder CD-ROM-Datenträger identifiziert, 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 darf nicht mehr als 4 Byte Speicher 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.

disk-description
Gibt ein %strkey%-Token oder eine "Zeichenfolge in Anführungszeichen" an, die den Inhalt und/oder den Zweck des Datenträgers beschreibt, der durch diskid identifiziert wird. Das Installationsprogramm kann dem Endbenutzer während der Installation den Wert dieser Zeichenfolge anzeigen, um z. B. einen Quelldatenträger zu identifizieren, der in einer bestimmten Phase des Installationsprozesses 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 sie führende oder nachfolgende Leerzeichen aufweist.

tag-or-cab-file
Dieser optionale Wert gibt den Namen einer Tagdatei oder einer .cab datei an , die auf dem Verteilungsdatenträger bereitgestellt wird, entweder im Installationsstammverzeichnis oder im durch Pfad angegebenen Unterverzeichnis, falls vorhanden. Der Wert sollte nur den Dateinamen und die Erweiterung angeben, kein 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 optional für feste Medien.

Wenn Windows installationsdateien nicht anhand des Namens auf dem Installationsmedium finden kann und tag-or-cab-file die Erweiterung aufweist.cab, Windows verwendet es als Namen einer Cabinet-Datei, die die Installationsdateien enthält.

Wenn ein . Die Cab-Erweiterung ist angegeben, Windows behandelt die Datei sowohl als Tagdatei als auch als Cabinet-Datei, wie im folgenden Abschnitt "Hinweise" erläutert.

Informationen zu Windows XP und höheren Versionen von Windows finden Sie auch unter Flags und Tag-File-Eintragswerte .

Unbenutzte
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 Verteilungsdatenträger an, der Quelldateien enthält. Der Pfad ist relativ zum Installationsstamm und wird als \dirname1 dirname2\... usw. ausgedrückt. Wenn dieser Wert in einem Eintrag ausgelassen wird, wird davon ausgegangen, dass sich Dateien im Installationsstamm des Verteilungsdatenträgers befinden.

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

flags
Ab Windows XP erzwingt das Festlegen dieser Einstellung auf 0x10 , dass Windows tag-or-cab-file als Cabinet-Dateinamen und tag-file als Tagdateinamen verwendet. Andernfalls sind Flags nur für die interne Verwendung vorgesehen.

Tag-Datei
Wenn flags ab Windows XP auf 0x10 festgelegt ist, gibt dieser optionale Wert den Namen einer Tagdatei an, die auf dem Verteilungsmedium entweder im Installationsstamm oder im durch Pfad angegebenen Unterverzeichnis bereitgestellt wird. Der Wert sollte den Dateinamen und die Erweiterung ohne Pfadinformationen angeben. Weitere Informationen finden Sie im Abschnitt Hinweise.

Hinweise

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

Diese Abschnitte werden nie in systemseitig 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 tag-or-cab-file-Parameter entweder eine Tagdatei oder eine CABINET-Datei angeben. Wenn dieses Format auftritt, verwendet Windows den folgenden Algorithmus:

  1. Behandeln Sie den Wert tag-or-cab-file als Tagdateinamen, und suchen Sie auf dem Installationsmedium nach der Datei. Wenn das Medium wechselbar ist und die Tagdatei nicht gefunden wird, bitten Sie den Benutzer, das richtige Medium anzugeben. Wenn das Medium fest ist und weder die Tagdatei noch die erste zu installierende Datei gefunden werden kann, fordern Sie den Benutzer zur Eingabe des richtigen Mediums auf.

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

  3. Behandeln Sie den Wert tag-or-cab-file 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, die Dateien nicht gefunden zu geben.

Das zweite Format wird in Windows XP und höheren Versionen von Windows unterstützt. Mit diesem Format können Sie die Einträge tag-or-cab-file, flags und tag-file verwenden, 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 mit dem dateinamen übereinstimmt, der durch tag-file angegeben wird. Wenn die Datei nicht gefunden wird, fordern Sie den Benutzer auf, das richtige Medium anzugeben. Wenn das Medium fest ist, suchen Sie entweder nach der Tagdatei oder der CABINET-Datei. Wenn keine Datei gefunden wird, fordern Sie den Benutzer zur Eingabe des richtigen Mediums auf.

  2. Versuchen Sie, Installationsdateien aus der durch tag-or-cab-file angegebenen.cab-Datei zu kopieren.

  3. Fordern Sie den Benutzer auf, die Dateien nicht gefunden zu geben.

Für jedes Format 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 sourceDisksNames die Erweiterung .x86, .ia64, .amd64 oder eine andere Architekturerweiterung 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. Wenn Sie beispielsweise einen Abschnitt mit Quelldatenträgernamen für ein x86-basiertes System angeben möchten, verwenden Sie den Abschnitt SourceDisksNames.x86 und nicht den Abschnitt SourceDisksNames.ntx86 . Verwenden Sie auf ähnliche Weise den Abschnitt SourceDisksNames.ia64 , um ein Itanium-basiertes System und einen Abschnitt SourceDisksNames.amd64 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 in SourceDisksNames.x86 nach einem Eintrag für Datenträger "2", bevor sie in SourceDisksNames.x86 suchen.

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

Beispiele

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"

Weitere Informationen

DestinationDirs

SourceDisksFiles

Version