Bagikan melalui

Menggunakan Penginstal Bersama UMDF

  • Artikel

Catatan

Jika driver Anda hanya menargetkan Windows 10, Anda tidak perlu mendistribusikan ulang WDF atau menyediakan Coinstaller dalam paket driver Anda. Untuk menargetkan Windows 10:

  1. Di Visual Studio, di halaman properti Pengaturan Proyek, di bawah Pengaturan Driver ->Versi OS Target, pilih Windows 10 atau yang lebih tinggi. Ini setara dengan menambahkan yang berikut ini ke file .vcxproj:
<PropertyGroup Label="Configuration">
<TargetVersion>Windows10</TargetVersion>
  1. Di Bagian Produsen INF, tentukan 10.0 sebagai versi OS target, sebagai berikut:
[Manufacturer]
%MyMfg% = MyMfg, NTamd64.10.0

Anda mungkin masih perlu mereferensikan coinstaller yang disediakan sistem seperti di bawah ini:

[Echo_Install.NT.CoInstallers] 
AddReg=CoInstallers_AddReg

[CoInstaller.AddReg]
HKR,,CoInstallers32,0x00010000,WudfCoinstaller.dll

Penginstal bersama memperbarui versi kerangka kerja yang disimpan di mesin dan memproses bagian file INF khusus kerangka kerja. Topik ini menjelaskan dua penginstal bersama UMDF dan ketika Anda perlu menyertakannya dengan paket penginstalan driver Anda atau mereferensikan penginstal bersama dalam file INF Anda.

Mendapatkan Paket Penginstal Bersama

Dalam Windows 8.1, pembaruan kerangka kerja yang dapat didistribusikan ulang yang disediakan Microsoft disertakan sebagai bagian dari Windows Driver Kit (WDK).

Untuk daftar lengkap konten direktori penginstal bersama, lihat Komponen Penginstalan untuk Driver KMDF.

Di antara komponen lain, direktori penginstal bersama berisi penginstal bersama pembaruan, yang disebut WUDFUpdate_MMmmm.dll, di mana MM adalah nomor versi utama, dan mmm adalah nomor versi minor.

Penginstal bersama pembaruan memperbarui versi kerangka kerja UMDF yang ada di komputer. Misalnya, jika komputer memiliki UMDF versi 1.9 dan penginstal bersama berisi versi 1.11, penginstal bersama memperbarui versi kerangka kerja komputer menjadi 1.11.

Sistem operasi mencakup penginstal bersama lain, yang disebut penginstal bersama konfigurasi, atau WudfCoinstaller.dll. Penginstal bersama konfigurasi memproses bagian khusus UMDF dari file INF driver dan membuat pembaruan yang diperlukan untuk registri.

Mereferensikan Penginstal bersama dari File INF Anda

Jika Anda menulis driver UMDF 2.0 untuk Windows 8.1, file INF Anda harus mereferensikan penginstal bersama konfigurasi. Karena penginstal bersama konfigurasi disertakan dalam sistem operasi, Anda tidak perlu mendistribusikannya kembali.

Jika Anda menulis driver UMDF 1.11 yang menargetkan sistem operasi sebelum Windows 8.1, Anda harus memastikan bahwa kerangka kerja versi 1.11 diinstal pada komputer yang menggunakan driver Anda. Berikut adalah tiga cara untuk melakukan ini:

  • Referensikan penginstal bersama pembaruan dalam file INF Anda, dan sertakan penginstal bersama pembaruan dalam paket penginstalan driver Anda. Ketika sistem operasi menginstal driver Anda, sistem operasi menjalankan penginstal bersama. Jika driver Anda akan didistribusikan melalui Windows Update, Anda harus memilih opsi ini.

  • Distribusikan ulang paket MSU yang relevan (misalnya umdf-1.11-Win-6.0.msu) bersama dengan aplikasi penyiapan yang memanggilnya. Anda dapat menemukan sampel aplikasi tersebut di subdirektori src\general\wdkinstall dari penginstalan WDK Anda. Anda dapat memilih opsi ini jika Anda menulis program penyiapan yang dikirim dengan perangkat dan harus dijalankan sebelum perangkat dapat digunakan. Jika Anda memilih opsi ini, file INF Anda harus mereferensikan penginstal bersama konfigurasi.

  • Mengandalkan Windows Update untuk menginstal versi kerangka kerja yang diperlukan pada komputer yang menggunakan driver Anda. Dimulai dengan versi 1.11 dari kerangka kerja, versi baru UMDF didistribusikan melalui Windows Update. Jika Anda memilih opsi ini, file INF Anda harus mereferensikan penginstal bersama konfigurasi.

Dalam file INF, Anda harus selalu mereferensikan penginstal bersama pembaruan atau penginstal bersama konfigurasi. Namun, mereferensikan kedua penginstal bersama di INF akan menyebabkan kesalahan penginstalan.

Bagian File INF untuk Penginstal Bersama

File INF driver Anda harus menyertakan bagian INF DDInstall.CoInstallers. Jika Anda mendistribusikan ulang penginstal bersama pembaruan, bagian DDInstall.CoInstallers Anda harus menyertakan direktif AddReg INF dan arahan INF CopyFiles, seperti yang ditunjukkan contoh berikut.

[MyDriver_Install.CoInstallers]
AddReg = MyDriver_Install.CoInstallers_AddReg
CopyFiles = MyDriver_CoInstallers_CopyFiles

Direktif INF AddReg mengidentifikasi bagian INF yang membuat entri registri CoInstallers32 .

[MyDriver_Install.CoInstallers_AddReg]
HKR,,CoInstallers32,0x00010000,"WudfUpdate_01011.dll"

Direktif INF CopyFiles mengidentifikasi bagian INF yang menyalin penginstal bersama dari perangkat penginstalan ke perangkat sistem.

[MyDriver_CoInstallers_CopyFiles]
WudfUpdate_01011.dll

Jika Anda mendistribusikan ulang paket MSU, bagian DDInstall.CoInstallers Anda harus menentukan arahan AddReg yang mereferensikan penginstal bersama konfigurasi.

[Echo_Install.NT.CoInstallers]
AddReg=CoInstallers_AddReg
[CoInstaller.AddReg]
HKR,,CoInstallers32,0x00010000,WudfCoinstaller.dll

File INF driver Anda harus selalu berisi bagian DDInstall.Wdf yang dibaca rekan penginstal setelah diinstal. Untuk informasi tentang arahan yang dapat ditentukan driver Anda di DDInstall.Wdf, lihat Menentukan Arahan WDF dalam File INF.

Anda dapat menghindari pembuatan beberapa file INF untuk beberapa versi kerangka kerja dengan menggunakan file INX dan alat Stampinf . Untuk informasi selengkapnya tentang file INX, lihat Menggunakan File INX untuk Membuat File INF.