Objek File Kerangka Kerja

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.

Objek file kerangka kerja diekspos ke driver oleh antarmuka IWDFFile. Ini adalah representasi struktur kerangka dari perangkat yang sedang dibuka. Saat aplikasi membuka perangkat melalui fungsiMicrosoft Win32CreateFile, kerangka kerja membuat objek file untuk mewakili instans perangkat yang dibuka. Oleh karena itu, objek file kerangka kerja secara konseptual setara dengan handle Win32 yang dikembalikan dari panggilan aplikasi ke CreateFile. Kerangka kerja dapat membuat beberapa objek file yang terkait dengan satu perangkat. Setiap objek file dibuat untuk setiap panggilan yang berhasil ke CreateFile. Semua operasi I/O, seperti baca dan tulis, ditargetkan ke instans objek file tertentu.

Catatan Semua permintaan yang diteruskan ke driver UMDF dikaitkan dengan objek file. Namun, permintaan yang diteruskan ke WDM dan driver KMDF terkadang tidak terkait dengan objek file.

Driver UMDF dapat memanggil metode IWDFIoRequest::GetFileObject untuk mendapatkan objek file yang terkait dengan permintaan.

Saat driver Anda memanggil GetFileObject, kerangka kerja akan menaikkan jumlah referensi pada antarmuka. Pengemudi Anda bertanggung jawab untuk melepaskan referensi setelah selesai dengan penunjuk antarmuka. Untuk melakukannya, gunakan penunjuk cerdas yang secara otomatis mengurangi jumlah referensi ketika objek keluar dari konteks, atau memanggil Rilis pada antarmuka ketika selesai dengannya. Untuk contoh kode yang memperlihatkan cara menggunakan penunjuk cerdas, lihat GetFileObject.