Bagikan melalui

Hierarki Objek Kerangka Kerja

  • Artikel

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.

Gambar berikut menunjukkan hierarki objek kerangka kerja induk-anak.

hierarki objek induk-anak umdf.

Cakupan masa pakai objek kerangka kerja ditentukan oleh lokasinya dalam hierarki dan bagaimana objek dibuat. Cakupan seumur hidup objek kerangka kerja termasuk dalam salah satu kategori berikut:

  • Kerangka kerja mengontrol pembuatan dan penghancuran objek.

    Kerangka kerja membuat dan menghancurkan objek, seperti objek driver dan objek perangkat, sebagai respons terhadap peristiwa sistem. Ketika driver mode pengguna memanggil metode IWDFDriver::CreateDevice untuk membuat objek perangkat, driver dapat secara opsional mendaftar untuk diberi tahu oleh kerangka kerja sebelum objek perangkat dihancurkan.

  • Kerangka kerja membuat objek; namun, driver mengontrol kapan objek dilepaskan.

    Objek permintaan I/O mengikuti pola ini ketika I/O disajikan ke driver. Kerangka kerja membuat objek permintaan, dan masa pakai objek permintaan valid hingga driver memanggil metode IWDFIoRequest::Complete .

  • Driver membuat objek dan mengaitkan objek dengan objek kerangka kerja lain.

    Beberapa objek kerangka kerja dibuat oleh metode yang diekspos oleh instans objek kerangka kerja induk yang harus dikaitkan dengan objek untuk tujuan manajemen seumur hidup. Metode IWDFDevice::CreateIoQueue adalah contoh pola ini. Jika panggilan ke IWDFDevice::CreateIoQueue berhasil, antrean I/O yang baru dibuat dikaitkan dengan instans perangkat yang diwakili antarmuka IWDFDevice . Ketika objek induk dihancurkan, kerangka kerja secara otomatis membersihkan instans anak. Driver diberi tahu tentang peristiwa ini jika driver mendaftarkan fungsi panggilan balik yang sesuai dengan kerangka kerja.