Bagian INF SourceDisksNames
Bagian SourceDisksNames mengidentifikasi disk distribusi atau disk CD-ROM yang berisi file sumber yang akan ditransfer ke komputer target selama penginstalan.
[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)
...
Entri
diskid
Menentukan bilangan bulat nonnegatif, dalam format desimal, yang mengidentifikasi disk sumber. Nilai ini tidak dapat memerlukan lebih dari 4 byte penyimpanan. Jika ada lebih dari satu disk sumber untuk distribusi, setiap entri diskid di bagian ini harus memiliki nilai unik, seperti 1, 2, 3, dan sebagainya.
deskripsi disk
Menentukan token %strkey% atau "string yang dikutip" yang menjelaskan isi dan/atau tujuan disk yang diidentifikasi oleh diskid. Alat penginstal dapat menampilkan nilai string ini kepada pengguna akhir selama penginstalan, misalnya, untuk mengidentifikasi disk sumber yang akan dimasukkan ke dalam drive pada tahap tertentu dari proses penginstalan.
Setiap spesifikasi %strkey% di bagian ini harus ditentukan di bagian String INF. Deskripsi disk apa pun yang bukan token %strkey% adalah string yang terlihat pengguna yang harus dibatasi oleh karakter tanda kutip ganda (") jika memiliki spasi di depan atau di belakangnya.
tag-or-cab-file
Nilai opsional ini menentukan nama file tag atau file kabinet (.cab) yang disediakan pada disk distribusi, baik di akar penginstalan atau di subdirektori yang ditentukan oleh jalur, jika ada. Nilai hanya boleh menentukan nama file dan ekstensi, bukan direktori atau subdirektori apa pun.
Windows menggunakan file tag untuk memverifikasi bahwa pengguna memasukkan diska penginstalan yang benar. File tag diperlukan untuk media yang dapat dilepas, dan bersifat opsional untuk media tetap.
Jika Windows tidak dapat menemukan file penginstalan berdasarkan nama pada media penginstalan, dan jika tag-or-cab-file memiliki ekstensi .kabin, Windows menggunakannya sebagai nama file kabinet yang berisi file penginstalan.
Jika . ekstensi kabin ditentukan, Windows memperlakukan file sebagai file tag dan file kabinet, seperti yang dijelaskan di bagian Keterangan berikut.
Untuk Windows XP dan versi Windows yang lebih baru, lihat juga nilai entri bendera dan file tag .
tidak digunakan
Entri ini tidak lagi didukung untuk Windows 2000 dan versi Windows yang lebih baru.
jalur
Nilai opsional ini menentukan jalur direktori pada disk distribusi yang berisi file sumber. Jalur ini relatif terhadap akar penginstalan dan dinyatakan sebagai \dirname1\dirname2..., dan sebagainya. Jika nilai ini dihilangkan dari entri, file diasumsikan berada di akar penginstalan disk distribusi.
Anda dapat menggunakan bagian INF SourceDisksFiles untuk menentukan subdirektori, relatif terhadap direktori jalur tertentu, yang berisi file sumber. Namun, file tag dan file kabinet harus berada di direktori jalur yang diberikan atau di akar penginstalan.
Bendera
Dimulai dengan Windows XP, mengatur ini ke 0x10 memaksa Windows untuk menggunakan tag-or-cab-file sebagai nama file kabinet, dan untuk menggunakan tag-file sebagai nama file tag. Jika tidak, bendera hanya untuk penggunaan internal.
tag-file
Dimulai dengan Windows XP, jika bendera diatur ke 0x10, nilai opsional ini menentukan nama file tag yang disediakan pada media distribusi, baik di akar penginstalan atau di subdirektori yang ditentukan oleh jalur. Nilai harus menentukan nama file dan ekstensi tanpa informasi jalur. Untuk informasi selengkapnya, lihat bagian Keterangan.
Keterangan
Bagian SourceDisksNames dapat memiliki sejumlah entri, satu untuk setiap disk distribusi. Setiap INF dengan bagian SourceDisksNames juga harus memiliki bagian INF SourceDisksFiles. (Menurut konvensi, bagian SourceDisksNames dan SourceDisksFiles mengikuti bagian Versi INF.)
Bagian ini tidak pernah muncul dalam file INF yang disediakan sistem. Sebagai gantinya, file INF yang disediakan sistem menentukan entri LayoutFile di bagian Versinya .
Entri di bagian SourceDisksNames dapat memiliki salah satu dari dua format, salah satunya hanya didukung di Windows XP dan versi Windows yang lebih baru.
Dalam format pertama, parameter tag-or-cab-file dapat menentukan file tag atau file kabinet. Ketika menemukan format ini, Windows menggunakan algoritma berikut:
Perlakukan nilai tag-or-cab-file sebagai nama file tag dan cari file pada media penginstalan. Jika media dapat dilepas dan file tag tidak ditemukan, minta pengguna untuk media yang benar. Jika media diperbaiki dan file tag maupun file pertama yang diinstal tidak dapat ditemukan, minta pengguna untuk media yang benar.
Coba salin file penginstalan langsung dari media.
Perlakukan nilai tag-or-cab-file sebagai file .cab dan cari file .
Coba salin file penginstalan dari file .cab .
Meminta pengguna untuk file tidak ditemukan.
Format kedua didukung di Windows XP dan versi Windows yang lebih baru. Dengan format ini, Anda dapat menggunakan entri tag-or-cab-file, flags, dan tag-file untuk menentukan file .cab dan file tag. Ketika menemukan format ini, Windows menggunakan algoritma berikut:
Jika media penginstalan dapat dilepas, cari file tag yang cocok dengan nama file yang ditentukan oleh tag-file. Jika file tidak ditemukan, minta pengguna untuk media yang benar. Jika media diperbaiki, cari file tag atau file kabinet. Jika tidak ada file yang ditemukan, minta pengguna untuk media yang benar.
Coba salin file penginstalan dari file .cab yang ditentukan oleh tag-or-cab-file.
Meminta pengguna untuk file tidak ditemukan.
Untuk salah satu format, Anda harus menyediakan file tag yang berbeda, dengan nama file yang berbeda, untuk setiap versi file driver.
Untuk mendukung distribusi file driver pada beberapa arsitektur sistem, Anda dapat menentukan bagian SourceDisksNames khusus arsitektur dengan menambahkan .x86, .ia64, .amd64, atau ekstensi arsitektur lainnya ke SourceDisksNames.
Ketahuilah bahwa, tidak seperti bagian lain seperti bagian DDInstall , ekstensi platform untuk bagian SourceDisksNames bukan .ntx86, .ntia64, .ntamd64, dll. Misalnya, untuk menentukan bagian nama disk sumber untuk sistem berbasis x86, gunakan bagian SourceDisksNames.x86 , bukan bagian SourceDisksNames.ntx86 . Demikian pula, gunakan bagian SourceDisksNames.ia64 untuk menentukan sistem berbasis Itanium dan bagian SourceDisksNames.amd64 untuk menentukan sistem berbasis x64.
Selama penginstalan, fungsi SetupAPI mencari bagian SourceDisksNames khusus arsitektur sebelum menggunakan bagian generik. Misalnya, jika, selama penginstalan pada platform berbasis x86, file INF mereferensikan disk "2", fungsi penginstalan perangkat mencari entri untuk disk "2" di SourceDisksNames.x86 sebelum melihat SourceDisksNames.
Fungsi penginstalan perangkat menggunakan SourceDisksNames dan SourceDisksNames.bagian arsitektur yang berada dalam file INF yang sama dengan bagian SourceDisksFiles yang relevan.
Contoh
Dalam contoh berikut, file write.exe sama untuk semua platform Windows dan terletak di subdirektori \common , di bawah akar penginstalan, pada disk distribusi CD-ROM. File cmd.exe adalah file khusus platform yang hanya digunakan pada platform berbasis 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
Contoh berikut menggunakan entri yang berisi spesifikasi terpisah untuk file .tag dan 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"
Lihat juga
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk