Menambahkan Perangkat

Peringatan

UMDF 2 adalah versi terbaru 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 Mulai menggunakan UMDF.

Kerangka kerja menambahkan objek perangkat untuk setiap perangkat yang dimuat dalam proses host driver. Untuk menambahkan perangkat, kerangka kerja memanggil metode IDriverEntry::OnDeviceAdd driver dan meneruskan antarmuka IWDFDriver dan IWDFDeviceInitialize dalam panggilan. Antarmuka IWDFDeviceInitialize yang disediakan hanya valid sebelum driver memanggil IWDFDriver::CreateDevice. Driver dapat memanggil metode IWDFDeviceInitialize berikut 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 pointer ke IWDFDeviceInitialize dalam panggilan ke metode IWDFDriver::CreateDevice untuk membuat objek perangkat UMDF untuk perangkat. Setelah objek perangkat kerangka kerja dibuat, driver melakukan panggilan ke 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.