Bagikan melalui

Membangun dan Memuat Driver WDF

  • Artikel

Topik ini menjelaskan cara memilih sistem operasi target dan versi kerangka kerja untuk proyek driver di Visual Studio.

Untuk menentukan apakah Anda perlu menyertakan komponen kerangka kerja yang dapat didistribusikan ulang dalam paket driver Anda, lihat Komponen Kerangka Kerja yang Dapat Didistribusikan Ulang.

Versi kerangka kerja mana yang harus saya gunakan?

  • Untuk menargetkan Windows XP, gunakan WDF 1.9 atau yang lebih lama.
  • Untuk menargetkan Windows Vista, Windows 7, atau Windows 8, gunakan WDF 1.11 atau yang lebih lama.
  • Untuk menargetkan Windows 8.1, gunakan KMDF 1.13 atau yang lebih lama, atau UMDF 1.x, atau UMDF 2.0.
  • Untuk menargetkan Windows 10 versi 1507, gunakan KMDF 1.15 atau yang lebih lama, atau UMDF 1.x, atau UMDF 2.15 atau yang lebih lama.

Untuk informasi terperinci tentang versi KMDF dan UMDF, lihat Riwayat Versi KMDF dan Riwayat Versi UMDF.

Bagaimana cara mengatur versi di Visual Studio?

Jika Anda membangun proyek driver untuk versi terbaru Windows dan versi KMDF atau UMDF terbaru, Anda dapat menyimpan default dan melewati langkah ini.

Jika tidak, ikutilah langkah-langkah berikut:

  • Klik kanan solusi dan pilih Configuration Manager. Atur Konfigurasi Proyek ke nilai yang diinginkan (misalnya Debug).
  • Klik kanan proyek driver dan pilih Properti. Buka Properti Konfigurasi-Model> Pengandar-Pengaturan> Pengandar. Ubah nilai KMDF Version Minor (Versi Target) atau UMDF Version Minor (Versi Target) di Pengaturan Model Driver ke nilai yang diinginkan. Untuk informasi tentang KMDF Version Minor (Minimum Required) dan UMDF Version Minor (Minimum Required), lihat Menentukan Minimum Diperlukan.

Anda dapat menggunakan Windows Driver Kit (WDK) yang dikirim dengan Windows 10 untuk membangun driver KMDF 1.9-1.29, serta driver UMDF 1.9-2.29.

Untuk informasi terperinci tentang versi KMDF dan UMDF, lihat Riwayat Versi KMDF dan Riwayat Versi UMDF.

Menautkan dan memuat

Saat Anda membuat proyek Windows Driver Frameworks (WDF) di Microsoft Visual Studio, MSBuild menautkan driver Anda ke pustaka kerangka kerja yang sesuai, pemuat pustaka, dan file stub, yang semuanya disertakan dalam WDK. (Pustaka dan pemuat juga disertakan dalam penginstal bersama kerangka kerja sehingga jika perlu, Anda dapat mendistribusikannya dengan paket driver Anda.)

File stub berisi rutinitas titik masuk khusus: FxDriverEntry. MSBuild menetapkan rutinitas FxDriverEntry stub sebagai titik masuk awal untuk driver berbasis kerangka kerja.

Ketika sistem operasi memuat driver berbasis kerangka kerja, sistem ini juga memuat file stub dan pemuat pustaka. Selanjutnya, sistem memanggil rutinitas FxDriverEntry file stub. Rutinitas ini kemudian memanggil loader. Loader menentukan versi pustaka kerangka kerja yang diperlukan driver lalu memuat versi pustaka yang benar sebagai layanan mode kernel (jika belum dimuat). Akhirnya, pustaka memanggil rutinitas DriverEntry driver.