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 nonnegative, in formato decimale, che identifica un disco di origine. Questo valore non può richiedere più di 4 byte di archiviazione. Se nella distribuzione sono presenti più dischi di origine, ogni voce discoid in questa sezione deve avere un valore univoco, ad esempio 1, 2, 3 e così via.
disk-description
Specifica un token %strkey% o una stringa "quoted" 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 di INF. Qualsiasi descrizione del disco che non è un token %strkey% è una stringa visibile dall'utente che deve essere delimitata da virgolette doppie (") se ha spazi iniziali o finali.
tag-or-cab-file
Questo valore facoltativo specifica il nome di un file di tag o 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 una directory o una sottodirectory.
Windows usa un file di tag per verificare che l'utente ha 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 cabinet che contiene i file di installazione.
Se un oggetto . L'estensione cab è specificata, Windows considera il file come file di tag e un file di cabinet, come illustrato nella sezione Osservazioni seguenti.
Per Windows XP e versioni successive di Windows, vedere anche i flag e i valori di voce del file tag .
Inutilizzati
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 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, rispetto a una determinata directory del percorso, che contiene file di origine. Tuttavia, i file tag e il file cabinet 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-cab e per usare tag-file come nome file tag. In caso contrario, i flag sono solo per l'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 del file e l'estensione senza informazioni sul percorso. Per altre informazioni, vedere la sezione Osservazioni .
Commenti
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 sezioni Versione .
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 cabinet. Quando si verifica questo formato, Windows usa l'algoritmo seguente:
Considerare il valore tag-or-cab-file come nome file tag e cercare il file nel supporto di installazione. Se il supporto è rimovibile e il file di tag non viene trovato, richiedere all'utente di specificare il supporto corretto. Se il supporto è fisso e non è possibile trovare né il file di tag né il primo file da installare, richiedere all'utente il supporto corretto.
Provare a copiare i file di installazione direttamente dal supporto.
Considerare il valore tag-or-cab-file come file .cab e cercare il file.
Provare a copiare i file di installazione dal file di.cab .
Richiedere all'utente di non trovare i file.
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 tag. Quando si verifica questo formato, Windows usa l'algoritmo seguente:
Se il supporto di installazione è rimovibile, cercare un file di tag corrispondente al nome del file specificato da tag-file. Se il file non viene trovato, richiedere all'utente di specificare il supporto corretto. Se il supporto è fisso, cercare il file di tag o il file di cabinet. Se non viene trovato alcun file, richiedere all'utente di specificare il supporto corretto.
Provare a copiare i file di installazione dal file .cab specificato da tag-or-cab-file.
Richiedere all'utente di non trovare i file.
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 .x86, .ia64, .amd64 o un'altra estensione dell'architettura a SourceDisksNamesNames.
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 nomi di disco 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 le 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 a disco "2", le funzioni di installazione del dispositivo cercano una voce per il disco "2" in SourceDisksNames.x86 prima di cercare In SourceDisksNamesNames.
Le funzioni di installazione del dispositivo usano SourceDisksNames e SourceDisksNames.sezioni dell'architettura presenti nello stesso file INF della sezione SourceDisksFiles pertinente.
Esempio
Nell'esempio seguente il file diwrite.exe è lo stesso per tutte le piattaforme Windows e si trova nella sottodirectory \common , nella radice di installazione, in un disco di distribuzione CD-ROM. Il file cmd.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 usate voci contenenti specifiche separate per file con estensione tag e file.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"