Bagikan melalui

Pembuatan File oleh Target I/O USB

  • 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.

Selama inisialisasinya, target I/O USB membuat objek file intra-stack, yang mewakili sesi default yang terus dibuka oleh target I/O USB. Untuk informasi selengkapnya tentang objek file intra-stack, lihat Membuat Objek File untuk Menangani I/O. Target I/O USB atau anak target pipa USB-nya menggunakan objek file ini untuk mengirim I/O apa pun yang mereka asal (misalnya, I/O untuk mendapatkan deskriptor konfigurasi USB).

Driver dapat menggunakan objek file intra-stack ini dalam fungsi format (misalnya, driver dapat meneruskan penunjuk ke objek file ini ke parameter pFile dalam panggilan ke metode IWDFIoTarget::FormatRequestForRead ) jika driver harus mengirim I/O pada sesi default objek file ini. Untuk mendapatkan objek file intra-stack, driver dapat memanggil metode IWDFIoTarget::GetTargetFile .

Objek file intra-stack ini ditutup ketika target I/O dibuang baik secara eksplisit, ketika driver memanggil metode IWDFObject::D eleteWdfObject pada target I/O, atau secara implisit, ketika induk target I/O dibuang.

Jika ada I/O yang tetap terutang pada objek file intra-stack ini pada saat penghapusan perangkat, objek file ini akan gagal ditutup, dan UMDF akan menghasilkan penghentian driver. Untuk informasi selengkapnya, lihat Membuat dan Menggunakan Objek File Driver-Created.