Bagikan melalui

Menemukan dan Memetakan Sumber Daya Perangkat Keras di Driver UMDF 1.x

  • Artikel

Peringatan

UMDF 2 adalah versi terbaru UMDF dan pengganti 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.

Jika Anda menggunakan UMDF versi 2.0 atau yang lebih baru, lihat Menemukan dan Memetakan Sumber Daya Perangkat Keras.

Driver UMDF 1.x menerima sumber daya perangkat keras dalam metode panggilan balik IPnpCallbackHardware2::OnPrepareHardware . Driver menggunakan antarmuka IWDFCmResourceList untuk meninjau daftar sumber daya yang diterjemahkan dan mengidentifikasi register yang dipetakan memori, port I/O, dan gangguan.

Driver melakukan iterasi melalui daftar sumber daya dengan memanggil IWDFCmResourceList::GetCount dan IWDFCmResourceList::GetDescriptor.

Jika driver menerima register yang dipetakan memori, driver harus memanggil IWDFDevice3::MapIoSpace untuk memetakan register sebelum dapat mengaksesnya. Biasanya, driver memetakan register-nya dalam metode IPnpCallbackHardware2::OnPrepareHardware . Driver membatalkan petak register di panggilan balik IPnpCallbackHardware2::OnReleaseHardware dengan memanggil IWDFDevice3::UnmapIoSpace. Perhatikan bahwa pemetaan tidak diperlukan untuk port I/O.

Untuk contoh yang menunjukkan bagaimana driver menemukan dan memetakan sumber daya register yang dipetakan memori, lihat IWDFDevice3::MapIoSpace.