Çerçeve Dosya Nesnesi

Uyarı

UMDF 2, UMDF'nin en son sürümüdür ve UMDF 1'in yerini alır. Tüm yeni UMDF sürücüleri UMDF 2 kullanılarak yazılmalıdır. UMDF 1'e yeni özellik eklenmiyor ve Windows 10'un daha yeni sürümlerinde UMDF 1 desteği sınırlı. Evrensel Windows sürücüleri UMDF 2 kullanmalıdır.

Arşivlenen UMDF 1 örnekleri, Windows 11, sürüm 22H2 - Mayıs 2022 Sürücü Örnekleri Güncelleştirme'de bulunabilir.

Daha fazla bilgi için bkz. UMDF ile Çalışmaya Başlama.

Çerçeve dosya nesnesi , IWDFFile arabirimi tarafından sürücülere sunulur. Bu, açılan cihazın çerçeve gösterimidir. Bir uygulama Microsoft Win32 CreateFile işlevi aracılığıyla cihazı açtığında, çerçeve açık cihaz örneğini temsil eden bir dosya nesnesi oluşturur. Bu nedenle, çerçeve dosyası nesnesi kavramsal olarak uygulamanın CreateFile çağrısından döndürülen Win32 tanıtıcısına eşdeğerdir. Çerçeve, tek bir cihazla ilişkili birden çok dosya nesnesi oluşturabilir. Her dosya nesnesi , CreateFile'a yapılan her başarılı çağrı için oluşturulur. Okuma ve yazma işlemleri gibi tüm G/Ç işlemleri belirli bir dosya nesnesi örneğine hedeflenir.

Not UMDF sürücülerine geçirilen tüm istekler dosya nesneleriyle ilişkilendirilir. Ancak , WDM ve KMDF sürücülerine geçirilen istekler bazen dosya nesneleriyle ilişkilendirilmemektedir.

BIR UMDF sürücüsü, bir istekle ilişkili dosya nesnesini almak için IWDFIoRequest::GetFileObject yöntemini çağırabilir.

Sürücünüz GetFileObject'i çağırdığında, çerçeve arabirimdeki başvuru sayısını artırır. Sürücünüz, arayüz işaretçisiyle işiniz bittiğinde referansı serbest bırakmaktan sorumludur. Bunu yapmak için, nesne bağlam dışına çıktığında başvuru sayısını otomatik olarak azaltan bir akıllı işaretçi kullanın veya onunla işiniz bittiğinde arabirimde Release komutunu çağırın. Akıllı işaretçinin nasıl kullanılacağını gösteren bir kod örneği için bkz. GetFileObject.