Riwayat Versi UMDF

Artikel
06/06/2024

Topik ini mencantumkan versi Kerangka Kerja Driver Mode Pengguna (UMDF), versi sistem operasi Windows yang sesuai, dan perubahan yang dilakukan di setiap rilis.

Tabel berikut ini memperlihatkan riwayat rilis pustaka UMDF. Anda dapat menggunakan bilah samping Di artikel ini di sebelah kanan untuk menavigasi dengan cepat ke versi tertentu.

Versi UMDF	Rilis awal	Disertakan dalam	Driver yang menggunakan versi UMDF ini berjalan pada
2.33	Windows 11, WDK versi 21H2; WDK untuk Windows Server 2022	Windows 11, versi 24H2; Windows 11, versi 23H2; Windows 11, versi 22H2; Windows 11, versi 21H2; Windows Server 2022	Windows 11, versi 21H2 dan yang lebih baru; Windows Server 2022 dan yang lebih baru
2,31	Windows 10, WDK versi 2004	Windows 10, versi 2004 (Pembaruan Mei 2020, Vibranium)	Windows 10, versi 2004 dan yang lebih baru
2.29	Tidak dirilis dalam WDK	Windows 10, versi 1903 (Pembaruan Maret 2019, 19H1)	Windows 10, versi 1903 dan yang lebih baru
2.27	Windows 10, WDK versi 1809	Windows 10, versi 1809 (Pembaruan Oktober 2018, Redstone 5)	Windows 10, versi 1809 dan yang lebih baru
2,25	Windows 10, WDK versi 1803	Windows 10, versi 1803 (Pembaruan April 2018, Redstone 4)	Windows 10, versi 1803 dan yang lebih baru
2.23	Windows 10, WDK versi 1709	Windows 10, versi 1709 (Fall Creators Update, Redstone 3)	Windows 10, versi 1709 dan yang lebih baru
2.21	Windows 10, WDK versi 1703	Windows 10, versi 1703 (Pembaruan Pembuat, Redstone 2)	Windows 10, versi 1703 dan yang lebih baru
2.19	Windows 10, WDK versi 1607	Windows 10, versi 1607 (Pembaruan Ulang Tahun, Redstone 1)	Windows 10, versi 1607, Windows Server 2016 dan yang lebih baru
2.17	Windows 10, WDK versi 1511	Windows 10, versi 1511 (Pembaruan November, Ambang 2)	Windows 10, versi 1511, Windows Server 2016 dan yang lebih baru
2.15	Windows 10 WDK	Windows 10, versi 1507 (Ambang 1)	Windows 10, versi 1507, Windows Server 2016 dan yang lebih baru
2.0	Windows Driver Kit (WDK) 8.1	Windows 8.1	Windows 8.1 dan yang lebih baru
1.11	Windows Driver Kit (WDK) 8	Windows 8	Windows Vista dan yang lebih baru
1.9	Windows 7 WDK	Windows 7	Windows XP dan yang lebih baru
1.7	Windows Server 2008 WDK	Windows Vista dengan Paket Layanan 1 (SP1), Windows Server 2008	Windows XP dan yang lebih baru
1.5	Windows Vista WDK	Windows Vista	Windows XP dan yang lebih baru

Anda dapat menggunakan Windows Driver Kit (WDK) dengan Microsoft Visual Studio 2022 untuk membangun driver yang berjalan di Windows 10 dan yang lebih baru.

Untuk bantuan menentukan versi WDF apa yang akan digunakan, lihat Versi kerangka kerja mana yang harus saya gunakan?.

Untuk informasi tentang fitur baru untuk driver UMDF di Windows 10, lihat Apa yang Baru untuk Driver WDF.

Untuk setiap bagian versi UMDF di bawah ini, versi Windows tempat versi dirilis tercantum dalam tanda kurung.

Versi terbaru - UMDF 2.33 (Windows 11, versi 21H2; Windows Server 2022)

Untuk perangkat yang menentukan SystemManagedIdleTimeout atau SystemManagedIdleTimeoutWithHint dalam enumerasi WDF_POWER_POLICY_IDLE_TIMEOUT_TYPE, saat memanggil makro WdfDeviceStopIdle dengan WaitForD0 diatur ke FALSE, jika perangkat masih dalam D0 dan periode batas waktu diam belum berlalu, WdfDeviceStopIdle mengembalikan STATUS_SUCCESS (dalam versi sebelumnya ini menghasilkan nilai pengembalian STATUS_PENDING).
Fungsi WdfDeviceWdmAssignPowerFrameworkSettings sekarang mendukung UMDF.
struktur WDF_POWER_FRAMEWORK_SETTINGS memiliki dua anggota baru (PoFxDeviceFlags dan DirectedPoFxEnabled) dan sekarang dapat digunakan dengan UMDF. Untuk UMDF, hanya anggota Size, PoFxDeviceFlags, dan DirectedPoFxEnabled yang digunakan. Bidang lain diabaikan dan harus diatur ke nol. Kerangka kerja melakukan ini secara otomatis ketika driver UMDF memanggil fungsi WDF_POWER_FRAMEWORK_SETTINGS_INIT.

UMDF 2.31 (Windows 10, versi 2004)

Menambahkan API baru WdfDeviceSetDeviceInterfaceStateEx
Meningkatkan API yang ada WdfDeviceGetSystemPowerAction
Menambahkan nilai registri HostProcessDbgBreakOnDriverLoad per driver. Untuk informasi, lihat Nilai Registri untuk Penelusuran Kesalahan Driver WDF.
Pengantar Kerangka Kerja Manajemen Daya Terarah

UMDF 2.29 (Windows 10, versi 1903)

Tidak berubah dari versi 2.27.

UMDF 2.27 (Windows 10, versi 1809)

Menambahkan API baru WdfDriverRetrieveDriverDataDirectoryString

UMDF 2.25 (Windows 10, versi 1803)

UMDF 2.23 (Windows 10, versi 1709)

Fungsionalitas pendamping ditambahkan hanya untuk penggunaan internal. Untuk DDI baru, lihat Ringkasan Panggilan Balik dan Metode WDF.

UMDF 2.21 (Windows 10, versi 1703)

WdfObjectDereferenceActual: Jenis parameter File diubah dari PCHAR ke PCCH.
WdfObjectReferenceActual: Jenis parameter File diubah dari PCHAR ke PCCH.
Menambahkan nilai registri WDF ObjectLeakDetectionLimit dan ObjectsForLeakDetection untuk men-debug pembuatan objek yang berlebihan. Untuk informasi selengkapnya, lihat Nilai Registri untuk Men-debug Driver WDF.

UMDF 2.19 (Windows 10, versi 1607)

Tidak ada perubahan atau penambahan untuk UMDF Versi 2.19.

UMDF 2.17 (Windows 10, versi 1511)

Versi ini menambahkan dukungan UMDF untuk antarmuka yang sudah ada berikut ini:

Untuk informasi selengkapnya, lihat Mengirimkan RUN ke Antrean I/O.

UMDF 2.15 (Windows 10, versi 1507)

Metode WdfDeviceOpenDevicemapKey baru memungkinkan driver untuk mengakses subkunci dan nilai di bawah HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP.
Driver UMDF dapat memanggil WdfIoTargetWdmGetTargetFileHandle untuk mendapatkan handel file ke driver mode kernel yang lebih rendah berikutnya di tumpukannya. Driver dapat menulis data ke handel tersebut, melewati abstraksi kerangka kerja untuk mengirim I/O ke target I/O lokal.
Pengemudi UMDF dapat meminta agar sopir bus yang mendasar menghitung ulang. Lihat WdfDeviceSetFailed.
Mengatur arahan UmdfDirectHardwareAccess tidak lagi selalu diperlukan untuk perangkat yang memiliki sumber daya koneksi. Lihat Menentukan Arahan WDF dalam File INF.
Kode sumber WDF tersedia untuk umum dari Windows Driver Frameworks. File simbol privat untuk WDF tersedia melalui Microsoft Symbol Server. Lihat juga Penelusuran Kesalahan dengan Sumber dan Video WDF: Men-debug driver Anda dengan kode sumber WDF.
Inflight Trace Recorder (IFR) sekarang tersedia. Perhatikan bahwa ini terpisah dari pencatat peristiwa kerangka kerja. Untuk informasi selengkapnya, lihat Inflight Trace Recorder (IFR) untuk mencatat jejak dan Menggunakan Inflight Trace Recorder di Driver KMDF dan UMDF.
Dukungan untuk interupsi untuk perangkat yang didukung GPIO. Untuk informasi selengkapnya, lihat Membuat Objek Interupsi.

UMDF 2.0 (Windows 8.1)

Selain fungsionalitas bersama yang dijelaskan dalam Memulai UMDF, UMDF versi 2.0 menambahkan:

Dukungan untuk timer yang tidak membangunkan sistem jika kedaluwarsa ketika sistem dalam keadaan daya rendah. Untuk informasi selengkapnya, lihat Menggunakan Timer.
Menambahkan anggota CanWakeDevice ke struktur WDF_INTERRUPT_CONFIG untuk mendukung gangguan yang dapat digunakan untuk membawa perangkat dari status Dx berdaya rendah kembali ke status D0 sepenuhnya. Untuk informasi selengkapnya, lihat Menggunakan Interupsi untuk Membangunkan Perangkat.
Manajemen daya komponen tunggal, status tunggal (F0) untuk driver UMDF. Untuk informasi selengkapnya, lihat WdfDeviceAssignS0IdleSettings.
Beberapa perintah ekstensi debugger di Wdfkd.dll sekarang dapat digunakan untuk driver UMDF 2.0 juga. Pustaka ekstensi juga berisi perintah ekstensi baru berikut yang dirancang khusus untuk penelusuran kesalahan driver UMDF 2.0:
- !wdfkd.wdfumdevstack
- !wdfkd.wdfumdevstacks
- !wdfkd.wdfumdownirp
- !wdfkd.wdfumfile
- !wdfkd.wdfumirp
- !wdfkd.wdfumirps
- !wdfkd.wdfdeviceinterrupts
  
  Untuk daftar perintah ekstensi dan penerapan kerangka kerja, lihat Ekstensi Debugger.
Pencatat peristiwa kerangka kerja, atau In-flight Recorder (IFR) telah diperbarui agar berfungsi untuk driver UMDF 2.0.
Ekstensi debugger WDF lainnya telah diperbarui untuk bekerja dengan driver UMDF 2.0. Untuk daftar lengkap perintah ekstensi, termasuk informasi tentang kerangka kerja mana yang berlaku, lihat Ekstensi Debugger untuk Driver WDF.
Menambahkan WdfIoTargetOpenLocalTargetByFile ke WDF_IO_TARGET_OPEN_TYPE untuk memungkinkan driver UMDF mengirim permintaan yang dibuat driver ke target yang lebih rendah yang memerlukan objek file terkait. Untuk informasi selengkapnya, lihat Keterangan WDF_IO_TARGET_OPEN_TYPE.
Rutinitas khusus UMDF berikut:
Metode KMDF/UMDF berikut yang dijelaskan dalam Mengakses Model Properti Perangkat Terpadu:
- WdfDeviceAllocAndQueryPropertyEx
- WdfDeviceAssignProperty
- WdfDeviceInitSetIoTypeEx
- WdfDeviceQueryPropertyEx
- WdfFdoInitAllocAndQueryPropertyEx
- WdfFdoInitQueryPropertyEx
  
  Untuk informasi selengkapnya, lihat Mengakses Model Properti Perangkat Terpadu.
Dukungan untuk jenis konfigurasi USB berikut di WdfUsbTargetDeviceSelectConfigType:
- WdfUsbTargetDeviceSelectConfigTypeSingleInterface
- WdfUsbTargetDeviceSelectConfigTypeMultiInterface
- WdfUsbTargetDeviceSelectConfigTypeInterfacesPairs
Dukungan untuk mengkueri jenis kemampuan berikut di WdfUsbTargetDeviceQueryUsbCapability:
- GUID_USB_CAPABILITY_DEVICE_CONNECTION_HIGH_SPEED_COMPATIBLE
- GUID_USB_CAPABILITY_DEVICE_CONNECTION_SUPER_SPEED_COMPATIBLE
Menambahkan Fungsi Akses WDF Register/Port

UMDF 1.11 (Windows 8)

Versi 1.11 menambahkan antarmuka panggilan balik yang disediakan driver berikut dan fungsi panggilan balik peristiwa:

Versi 1.11 menambahkan antarmuka yang disediakan kerangka kerja berikut:

Versi 1.11 menambahkan kemampuan berikut ke driver berbasis UMDF:

Mengakses Interupsi Perangkat Keras dan Penanganan
Menggunakan Pengumpulan Perangkat di Driver UMDF
Menambahkan UmdfHostProcessSharing, UmdfDirectHardwareAccess, UmdfRegisterAccessMode, UmdfFileObjectPolicy, dan Direktif UmdfFsContextUsePolicy , dijelaskan dalam Menentukan Arahan WDF dalam File INF
Pengidentifikasi keamanan (SID) terkenal untuk driver UMDF
Dukungan penyimpanan properti terpadu, dijelaskan dalam Menggunakan Registri di Driver berbasis UMDF
IoGetDeviceObjectPointer terintegrasi untuk bekerja dengan UMDF. Dalam versi sebelumnya, rutinitas ini menutup handel ke objek perangkat setelah mengambil referensi pada handel perangkat. Perilaku ini tidak kompatibel dengan harapan UMDF bahwa permintaan pembersihan pada objek perangkat tidak akan terjadi sampai setelah semua I/O selesai.
Membuat Minidriver HID berbasis UMDF
Dukungan yang ditingkatkan untuk Mendukung Power-Down Menganggur di Driver berbasis UMDF. Kerangka kerja sekarang dapat menempatkan perangkat dalam status daya D3cold ketika periode batas waktu diam kedaluwarsa. Kerangka kerja juga dapat menyebabkan perangkat kembali ke status kerjanya (D0) ketika sistem kembali ke status kerja (S0).
Sampel berikut baru di UMDF 1.11: WudfVhidmini, NetNfpProvider.

UMDF 1.9 (Windows 7)

Versi 1.9 menambahkan antarmuka panggilan balik yang disediakan driver berikut:

Versi 1.9 menambahkan antarmuka yang disediakan kerangka kerja berikut:

Antarmuka ini menambahkan kemampuan berikut ke driver berbasis UMDF:

Target I/O jarak jauh
Kepemilikan kebijakan daya
Metode akses buffer I/O langsung
Pembaca berkelanjutan untuk perangkat USB
Dukungan yang ditingkatkan untuk antarmuka perangkat
Kemampuan yang ditingkatkan untuk membatalkan permintaan I/O
Akses yang ditingkatkan ke registri

Bagikan melalui