Membuat driver fungsi perangkat baru

Dalam artikel ini, kami menjelaskan cara menggunakan Visual Studio untuk mulai menulis driver fungsi perangkat baru. Driver fungsi perangkat berbeda dari driver filter, driver perangkat lunak, dan driver sistem file, yang kami bahas di artikel lain. Untuk mempelajari tentang driver fungsi perangkat dan perbedaannya dengan jenis driver lain, lihat Apa itu Driver?, Memilih Model Driver, dan Simpul Perangkat dan Tumpukan Perangkat.

Untuk memulai, tentukan di mana perangkat Anda cocok dalam daftar teknologi yang dijelaskan dalam Teknologi Perangkat dan Driver. Untuk mempelajari tentang model driver mana yang tersedia untuk perangkat Anda, lihat dokumentasi untuk teknologi tertentu. Model driver yang direkomendasikan bervariasi dari satu teknologi ke teknologi berikutnya. Untuk beberapa teknologi, dokumentasi merekomendasikan penggunaan Kerangka Kerja Driver Mode Pengguna (UMDF) atau Kerangka Kerja Driver Mode Kernel (KMDF). Untuk teknologi lain, dokumentasi menjelaskan cara membuat minidriver yang merupakan bagian dari pasangan driver. Minidriver dikenal dengan berbagai nama, termasuk miniport dan miniclass.

Tentukan mana dari kasus berikut yang menjelaskan rekomendasi model driver Anda dan ikuti langkah-langkahnya:

Kasus 1: Dokumentasi untuk teknologi Anda merekomendasikan UMDF

1. Mulai Visual Studio.
2. Pilih Buat proyek baru dalam dialog startup, atau pilih Baru | Proyek dari menu File Visual Studio.
3. Di panel kanan kotak dialog Buat proyek baru , temukan dan pilih Driver Mode Pengguna (UMDF V2).
4. Pilih Selanjutnya.
5. Isi kotak Nama proyek, Lokasi, dan Nama solusi , dan pilih Buat. Untuk informasi selengkapnya, lihat Menulis Driver UMDF Berdasarkan Templat.

   Nota

   Saat membuat driver UMDF baru, Anda harus memilih nama driver yang memiliki 32 karakter atau kurang. Batas panjang ini didefinisikan dalam wdfglobals.h.

6. Pada titik ini, Anda memiliki proyek driver yang mengimplementasikan kode umum yang diperlukan oleh sebagian besar driver UMDF. Sekarang Anda dapat menyediakan kode yang khusus untuk perangkat Anda. Lihat dokumentasi untuk teknologi Anda untuk mempelajari tentang antarmuka yang perlu Anda terapkan.

Kasus 2: Dokumentasi untuk teknologi Anda merekomendasikan KMDF

1. Mulai Visual Studio.
2. Pilih Buat proyek baru dalam dialog startup, atau pilih Baru | Proyek dari menu File Visual Studio.
3. Di panel kanan kotak dialog Buat proyek baru , temukan dan pilih Driver Mode Kernel (KMDF).
4. Pilih Selanjutnya.
5. Isi kotak Nama proyek, Lokasi, dan Nama solusi , dan pilih Buat. Untuk informasi selengkapnya, lihat Menulis Driver KMDF Berdasarkan Templat.

   Nota

   Saat membuat driver KMDF baru, Anda harus memilih nama driver yang memiliki 32 karakter atau kurang. Batas panjang ini didefinisikan dalam wdfglobals.h.

6. Pada titik ini, Anda memiliki proyek driver yang mengimplementasikan kode umum yang diperlukan oleh sebagian besar driver KMDF. Sekarang Anda dapat menyediakan kode yang khusus untuk perangkat Anda. Lihat dokumentasi untuk teknologi Anda untuk mempelajari tentang metode yang perlu Anda terapkan.

Kasus 3: Dokumentasi untuk teknologi Anda menjelaskan model minidriver

Jika teknologi perangkat Anda memiliki miniport, miniclass, atau beberapa model minidriver lainnya, periksa untuk melihat apakah Visual Studio memiliki templat tertentu untuk model tersebut.

1. Mulai Visual Studio.
2. Pilih Buat proyek baru dalam dialog startup, atau pilih Baru | Proyek dari menu File Visual Studio.
3. Di panel kanan kotak dialog Buat proyek baru , telusuri daftar templat yang diinstal untuk menemukan templat untuk jenis driver yang perlu Anda tulis.
4. Jika Anda menemukan templat untuk jenis driver Anda, pilih templat tersebut.
5. Pilih Selanjutnya.
6. Isi kotak Nama proyek, Lokasi, dan Nama solusi , dan pilih Buat.
7. Jika Anda disajikan dengan wizard driver, ikuti panduan untuk membuat proyek driver Anda.
8. Pada titik ini, Anda memiliki proyek driver yang mengimplementasikan kode umum yang diperlukan oleh driver Anda. Sekarang Anda dapat menyediakan kode yang khusus untuk perangkat Anda. Lihat dokumentasi untuk teknologi Anda untuk mempelajari tentang fungsi yang perlu Anda terapkan.

Jika teknologi perangkat Anda memiliki model minidriver, dan Anda tidak dapat menemukan templat tertentu untuk jenis minidriver Anda, templat Windows Driver Model (WDM) kemungkinan besar akan menjadi titik awal Anda. Lihat dokumentasi khusus teknologi Anda untuk panduan. Dalam kasus yang jarang terjadi, Anda dapat menggunakan KMDF untuk menulis minidriver, tetapi biasanya titik awalnya adalah WDM.

1. Mulai Visual Studio.
2. Pilih Buat proyek baru dalam dialog startup, atau pilih Baru | Proyek dari menu File Visual Studio.
3. Di panel kanan kotak dialog Buat proyek baru , temukan dan pilih Kosongkan Driver WDM.
4. Pilih Selanjutnya.
5. Isi kotak Nama proyek, Lokasi, dan Nama solusi , dan pilih Buat.
6. Pada titik ini, Anda memiliki proyek driver WDM kosong. Di jendela Penjelajah Solusi, klik kanan proyek driver Anda, dan pilih Tambahkan | Item Baru.
7. Dalam kotak dialog Tambahkan Item Baru , masukkan nama untuk file .cpp Anda, dan pilih Tambahkan.

   Nota

   Jika Anda ingin membuat file .c alih-alih file .cpp, masukkan nama yang memiliki ekstensi .c.

8. Lihat dokumentasi untuk teknologi Anda untuk mempelajari tentang fungsi yang perlu Anda terapkan. Saat menerapkan dan mengatur fungsi, Anda mungkin memutuskan untuk menambahkan lebih banyak file .cpp atau .c.