Membuat Objek Interupsi (UMDF 1)

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.

Driver UMDF yang menangani gangguan perangkat keras perangkat harus membuat objek interupsi kerangka kerja untuk setiap gangguan yang dapat didukung setiap perangkat.

Biasanya, driver membuat objek kerangka interupsi di IDriverEntry::OnDeviceAdd. Namun, Anda juga dapat membuat objek interupsi di IPnpCallbackHardware2::OnPrepareHardware.

Untuk membuat objek interupsi kerangka kerja, driver Anda harus menginisialisasi struktur WUDF_INTERRUPT_CONFIG dan meneruskannya ke metode IWDFDevice3::CreateInterrupt . Metode ini mendaftarkan fungsi panggilan balik peristiwa yang disediakan oleh pengemudi berikut:

OnInterruptEnable
Mengaktifkan interupsi perangkat keras.

OnInterruptDisable
Menonaktifkan interupsi perangkat keras.

OnInterruptIsr
Rutinitas layanan interupsi (ISR) untuk interupsi.

OnInterruptWorkItem
Rutinitas pekerja untuk menangani interupsi.

Secara opsional, driver dapat memanggil IWDFInterrupt::SetPolicy atau IWDFInterrupt::SetExtendedPolicy untuk menentukan parameter interupsi tambahan.

Framework memanggil fungsi callback driver IDriverEntry::OnDeviceAdd sebelum manajer Plug and Play (PnP) menetapkan sumber daya sistem, seperti vektor interupsi, ke perangkat. Setelah manajer PnP menetapkan sumber daya, kerangka kerja menyimpan sumber daya interupsi di objek interupsi perangkat. (Driver yang tidak mendukung Plug and Play tidak dapat menggunakan objek interupsi.)

Interupsi yang dipicu oleh pesan (MSI) didukung di Windows Vista dan versi sistem operasi yang lebih baru. Untuk mengaktifkan sistem operasi guna mendukung MSI untuk perangkat Anda, file INF driver Anda harus mengatur beberapa nilai dalam registri. Untuk informasi tentang cara mengatur nilai-nilai ini, lihat Mengaktifkan Interupsi Message-Signaled pada Registri.

Jika perangkat dapat mendukung sejumlah pesan MSI, manajer PnP akan mencoba menetapkan jumlah pesan tersebut ke perangkat. Jika manajer PnP tidak dapat menetapkan semua pesan yang dapat didukung perangkat, itu hanya akan menetapkan satu pesan ke perangkat.

Driver Anda harus membuat objek interupsi kerangka kerja untuk setiap vektor interupsi atau pesan MSI yang dapat didukung perangkat. Jika manajer PnP tidak memberikan semua sumber daya interupsi yang dapat didukung perangkat, objek interupsi tambahan tidak akan digunakan, dan fungsi panggilan baliknya tidak akan dipanggil.