Menambahkan Perangkat

Peringatan

UMDF 2 adalah versi terbaru dari UMDF dan supersedes UMDF 1. Semua driver UMDF baru harus ditulis menggunakan UMDF 2. Tidak ada fitur baru yang ditambahkan ke UMDF 1 dan ada dukungan terbatas untuk UMDF 1 pada versi Windows 10 yang lebih baru. Driver Universal Windows harus menggunakan UMDF 2.

Sampel UMDF 1 yang diarsipkan dapat ditemukan di Windows 11, versi 22H2 - Pembaruan Sampel Driver Mei 2022.

Untuk informasi selengkapnya, lihat Memulai UMDF.

Framework menambahkan objek perangkat untuk setiap perangkat yang dimuat dalam proses driver host. Untuk menambahkan perangkat, kerangka kerja memanggil metode IDriverEntry::OnDeviceAdd dan meneruskan antarmuka IWDFDriver dan IWDFDeviceInitialize dalam panggilan. Antarmuka IWDFDeviceInitialize yang disediakan hanya valid sebelum driver memanggil IWDFDriver::CreateDevice. Pengandar dapat memanggil metode berikut dari IWDFDeviceInitialize untuk melakukan operasi berikut:

• Driver memanggil metode IWDFDeviceInitialize::RetrieveDevicePropertyStore untuk mengambil antarmuka IWDFNamedPropertyStore untuk penyimpanan properti perangkat. Driver dapat menggunakan IWDFNamedPropertyStore untuk mengambil dan mengatur properti untuk perangkat.

• Driver memanggil metode IWDFDeviceInitialize::SetLockingConstraint untuk menentukan bagaimana fungsi panggilan baliknya dipanggil oleh kerangka kerja.

• Driver memanggil metode IWDFDeviceInitialize::SetFilter untuk mengaktifkan perangkat sebagai perangkat filter.

Setelah driver menggunakan IWDFDeviceInitialize untuk menginisialisasi perangkat, driver meneruskan penunjuk ke IWDFDeviceInitialize dalam panggilan ke metode IWDFDriver::CreateDevice untuk membuat objek perangkat UMDF untuk perangkat. Setelah objek perangkat kerangka kerja dibuat, driver memanggil metode IWDFDevice::CreateIoQueue untuk membuat antrean I/O baca dan tulis. Dalam panggilan IWDFDevice::CreateIoQueue ini, driver harus mengidentifikasi bagaimana ia menerima permintaan dari antrean I/O. Untuk informasi selengkapnya, lihat Mengonfigurasi Mode Pengiriman untuk Antrean I/O.