Sezione INF SourceDisksNames

Una sezione SourceDisksNames identifica i dischi di distribuzione o i dischi CD-ROM che contengono i file di origine da trasferire nel computer di destinazione durante l'installazione.

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

Voci

diskid
Specifica un intero non negativo, in formato decimale, che identifica un disco di origine. Questo valore non può richiedere più di 4 byte di spazio di archiviazione. Se sono presenti più dischi di origine per la distribuzione, ogni voce diskid in questa sezione deve avere un valore univoco, ad esempio 1, 2, 3 e così via.

disk-description
Specifica un %strkey% token o una "stringa tra virgolette" che descrive il contenuto e/o lo scopo del disco identificato da diskid. Il programma di installazione può visualizzare il valore di questa stringa all'utente finale durante l'installazione, ad esempio per identificare un disco di origine da inserire in un'unità in una fase specifica del processo di installazione.

Ogni %specifica strkey% in questa sezione deve essere definita nella sezione Stringhe INF. Qualsiasi descrizione del disco che non è un %token strkey% è una stringa visibile dall'utente che deve essere delimitata da virgolette doppie (") se contiene spazi iniziali o finali.

tag-or-cab-file
Questo valore facoltativo specifica il nome di un file di tag o di un file cab (.cab) fornito nel disco di distribuzione, nella radice di installazione o nella sottodirectory specificata dal percorso, se presente. Il valore deve specificare solo il nome e l'estensione del file, non qualsiasi directory o sottodirectory.

Windows usa un file di tag per verificare che l'utente abbia inserito il disco di installazione corretto. I file di tag sono necessari per i supporti rimovibili e sono facoltativi per i supporti fissi.

Se Windows non riesce a trovare i file di installazione in base al nome nel supporto di installazione e se tag-or-cab-file ha l'estensione .cab, Windows lo usa come nome di un file cab che contiene i file di installazione.

Se è un oggetto . Viene specificata l'estensione cab, Windows considera il file sia come file di tag che come file CAB, come illustrato nella sezione Osservazioni seguente.

Per Windows XP e versioni successive di Windows, vedere anche i flag e i valori delle voci dei file di tag.

inutilizzato
Questa voce non è più supportata per Windows 2000 e versioni successive di Windows.

path
Questo valore facoltativo specifica il percorso della directory nel disco di distribuzione che contiene i file di origine. Il percorso è relativo alla radice di installazione ed è espresso come \dirname1\dirname2...e così via. Se questo valore viene omesso da una voce, si presuppone che i file si trovino nella radice di installazione del disco di distribuzione.

È possibile usare una sezione INF SourceDisksFiles per specificare sottodirectory, relative a una determinata directory di percorso, che contengono file di origine. Tuttavia, i file tag e il file CAB devono risiedere nella directory del percorso specificato o nella radice di installazione.

flags
A partire da Windows XP, impostarlo su 0x10 forza Windows a usare tag-or-cab-file come nome file cab e per usare tag-file come nome file tag. In caso contrario, i flag sono solo per uso interno.

tag-file
A partire da Windows XP, se i flag sono impostati su 0x10, questo valore facoltativo specifica il nome di un file di tag fornito nel supporto di distribuzione, nella radice di installazione o nella sottodirectory specificata dal percorso. Il valore deve specificare il nome file e l'estensione senza informazioni sul percorso. Per altre informazioni, vedere la sezione Osservazioni.

Remarks

Una sezione SourceDisksNames può avere un numero qualsiasi di voci, una per ogni disco di distribuzione. Qualsiasi INF con una sezione SourceDisksNames deve avere anche una sezione INF SourceDisksFiles. Per convenzione, le sezioni SourceDisksNames e SourceDisksFiles seguono la sezione Versione INF.

Queste sezioni non vengono mai visualizzate nei file INF forniti dal sistema. I file INF forniti dal sistema specificano invece le voci LayoutFile nelle relative sezioni Version .

Le voci in una sezione SourceDisksNames possono avere uno dei due formati, uno dei quali è supportato solo in Windows XP e versioni successive di Windows.

Nel primo formato, il parametro tag-or-cab-file può specificare un file tag o un file CAB. Quando si verifica questo formato, Windows usa l'algoritmo seguente:

  1. Considerare il valore tag-or-cab-file come nome file di tag e cercare il file nel supporto di installazione. Se il supporto è rimovibile e il file di tag non viene trovato, richiedere all'utente il supporto corretto. Se il supporto è fisso e non è possibile trovare il file di tag né il primo file da installare, richiedere all'utente il supporto corretto.

  2. Tentare di copiare i file di installazione direttamente dal supporto.

  3. Considerare il valore tag-or-cab-file come file .cab e cercare il file.

  4. Tentare di copiare i file di installazione dal file di.cab .

  5. Richiedere all'utente i file non trovati.

Il secondo formato è supportato in Windows XP e versioni successive di Windows. Con questo formato, è possibile usare le voci tag-or-cab-file, flag e tag-file per specificare sia un file .cab che un file di tag. Quando rileva questo formato, Windows usa l'algoritmo seguente:

  1. Se il supporto di installazione è rimovibile, cercare un file di tag corrispondente al nome file specificato da tag-file. Se il file non viene trovato, richiedere all'utente il supporto corretto. Se il supporto è fisso, cercare il file di tag o il file cab. Se non viene trovato alcun file, richiedere all'utente il supporto corretto.

  2. Tentare di copiare i file di installazione dal file .cab specificato da tag-or-cab-file.

  3. Richiedere all'utente i file non trovati.

Per entrambi i formati, è necessario specificare un file di tag diverso, con un nome di file diverso, per ogni versione dei file del driver.

Per supportare la distribuzione dei file driver in più architetture di sistema, è possibile specificare una sezione SourceDisksNames specifica dell'architettura aggiungendo un file con estensione x86, ia64, amd64 o un'altra estensione dell'architettura a SourceDisksNames.

Tenere presente che, a differenza di altre sezioni, ad esempio una sezione DDInstall , le estensioni della piattaforma per una sezione SourceDisksNames non sono .ntx86, .ntia64, .ntamd64 e così via. Ad esempio, per specificare una sezione dei nomi dei dischi di origine per un sistema basato su x86, usare una sezione SourceDisksNames.x86 , non una sezione SourceDisksNames.ntx86 . Analogamente, usare una sezione SourceDisksNames.ia64 per specificare un sistema basato su Itanium e una sezione SourceDisksNames.amd64 per specificare un sistema basato su x64.

Durante l'installazione, le funzioni SetupAPI cercano sezioni SourceDisksNames specifiche dell'architettura prima di usare la sezione generica. Se, ad esempio, durante l'installazione in una piattaforma basata su x86, un file INF fa riferimento al disco "2", le funzioni di installazione del dispositivo cercano una voce per il disco "2" in SourceDisksNames.x86 prima di cercare sourceDisksNamesNames.

Le funzioni di installazione del dispositivo usano SourceDisksNames e SourceDisksNames.sezioni dell'architettura che si trovano nello stesso file INF della sezione SourceDisksFiles pertinente.

Esempi

Nell'esempio seguente il file write.exe è lo stesso per tutte le piattaforme Windows e si trova nella sottodirectory \common, sotto la radice di installazione, in un disco di distribuzione CD-ROM. Il filecmd.exe è un file specifico della piattaforma usato solo su piattaforme basate su 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

Nell'esempio seguente vengono utilizzate voci che contengono specifiche separate per i file con estensione tag e .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"

Vedere anche

DestinationDirs

SourceDisksFiles

Versione