Riwayat Versi KMDF

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

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

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 daftar lengkap panggilan balik dan metode, dan kerangka kerja dan versi mana yang berlaku, lihat Ringkasan Panggilan Balik dan Metode WDF.

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

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

Versi terbaru - KMDF 1.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).
• struktur WDF_POWER_FRAMEWORK_SETTINGS memiliki dua anggota baru (PoFxDeviceFlags dan DirectedPoFxEnabled).

KMDF 1.31 (Windows 10, versi 2004)

• Menambahkan API baru WdfDeviceSetDeviceInterfaceStateEx
• Meningkatkan API yang ada WdfDeviceGetSystemPowerAction
• Menambahkan API baru WdfPdoInitRemovePowerDependencyOnParent
• Pengantar Kerangka Kerja Manajemen Daya Terarah

KMDF 1.29 (Windows 10, versi 1903)

Tidak berubah dari versi 1.25.

KMDF 1.27 (Windows 10, versi 1809)

Tidak berubah dari versi 1.25.

KMDF 1.25 (Windows 10, versi 1803)

• Membangun driver WDF untuk beberapa versi Windows.

KMDF 1.23 (Windows 10, versi 1709)

• Fungsionalitas pendamping ditambahkan hanya untuk penggunaan internal. Untuk informasi selengkapnya, lihat Wdfcompanion.h.

KMDF 1.21 (Windows 10, versi 1703)

• WdfFileObjectGetInitiatorProcessId sebelumnya hanya UMDF, sekarang tersedia di KMDF.
• WdfRequestGetRequestorProcessId sebelumnya hanya UMDF, sekarang tersedia di KMDF.
• 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.
• Alat perangkat lunak SleepStudy melaporkan jumlah referensi daya yang dimiliki driver KMDF yang mencegah sistem tidur. Untuk informasi selengkapnya, lihat SleepStudy siaga modern.

KMDF 1.19 (Windows 10, versi 1607)

• Menambahkan WdfDmaTransactionSetSingleTransferRequirement
• Menambahkan bendera WDF_DMA_ENABLER_CONFIG_REQUIRE_SINGLE_TRANSFER di WDF_DMA_ENABLER_CONFIG_FLAGS
• Menambahkan nilai pengembalian STATUS_WDF_TOO_MANY_TRANSFERS untuk WdfDmaTransactionInitialize dan WdfDmaTransactionDmaCompleted
• Menambahkan pesan output untuk output transfer tunggal ke !wdfkd.wdfdmatransaction dan !wdfkd.wdfdmaenabler
• Untuk informasi selengkapnya tentang DMA transfer tunggal, lihat Menggunakan DMA Transfer Tunggal.

KMDF 1.15 (Windows 10, versi 1507)

• Metode WdfDeviceOpenDevicemapKey baru memungkinkan driver untuk mengakses subkunci dan nilai di bawah HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP.
• 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.

KMDF 1.13 (Windows 8.1)

KMDF versi 1.13 menambahkan fungsionalitas berikut:

• 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.
• Dukungan untuk timer resolusi tinggi. Untuk informasi selengkapnya, lihat Menggunakan Timer.
• Dukungan untuk timer yang tidak membangunkan sistem jika kedaluwarsa ketika sistem dalam keadaan daya rendah. Untuk informasi selengkapnya, lihat Menggunakan Timer.
• Metode KMDF/UMDF berikut yang dijelaskan dalam Mengakses Model Properti Perangkat Terpadu:
  • WdfDeviceAllocAndQueryPropertyEx
  • WdfDeviceAssignProperty
  • WdfDeviceInitSetIoTypeEx
  • WdfDeviceQueryPropertyEx
  • WdfFdoInitAllocAndQueryPropertyEx
  • WdfFdoInitQueryPropertyEx

Untuk informasi tentang versi UMDF, lihat Riwayat Versi UMDF.

KMDF 1.11 (Windows 8)

Versi 1.11 menambahkan fungsionalitas berikut:

• DMA mode sistem

• Dukungan untuk interupsi tingkat pasif

• Status daya fungsional untuk beberapa komponen dalam satu perangkat

• Mengirimkan IRP ke Antrean I/O

• Metode berikut:

  • WdfDeviceConfigureWdmIrpDispatchCallback
  • WdfDeviceInitSetReleaseHardwareOrderOnFailure
  • WdfDeviceInitSetRemoveLockOptions
  • WdfDeviceWdmDispatchIrp
  • WdfDmaEnablerConfigureSystemProfile
  • WdfDmaTransactionAllocateResources
  • WdfDmaTransactionCancel
  • WdfDmaTransactionFreeResources
  • WdfDmaTransactionGetTransferInfo
  • WdfDmaTransactionInitializeUsingOffset
  • WdfDmaTransactionSetChannelConfigurationCallback
  • WdfDmaTransactionSetDeviceAddressOffset
  • WdfDmaTransactionSetImmediateExecution
  • WdfDmaTransactionSetTransferCompleteCallback
  • WdfDmaTransactionWdmGetTransferContext
  • WdfInterruptQueueWorkItemForIsr
  • WdfInterruptReportActive
  • WdfInterruptReportInactive
  • WdfInterruptTryToAcquireLock
  • WdfIoQueueStopAndPurge
  • WdfIoQueueStopAndPurgeSynchronously
  • WdfIoTargetPurge
  • WdfUsbTargetDeviceCreateIsochUrb
  • WdfUsbTargetDeviceCreateUrb
  • WdfUsbTargetDeviceCreateWithParameters
  • WdfUsbTargetDeviceQueryUsbCapability

• Menambahkan EvtDeviceUsageNotificationEx.

• Menambahkan anggota IdleTimeoutType dan ExcludeD3Cold ke WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS.

• Menambahkan anggota ReportInactiveOnPowerDown ke WDF_INTERRUPT_CONFIG.

• Menambahkan nilai WdfIoTargetPurged ke WDF_IO_TARGET_STATE.

• Menambahkan nilai WdfSpecialFileBoot ke WDF_SPECIAL_FILE_TYPE.

• Menambahkan DbgWaitForSignalTimeoutInSec ke Nilai Registri untuk Driver berbasis Kerangka Kerja Debugging.

• Menambahkan sampel InstallWdf, MultiComp, dan SingleComp .

KMDF 1.9 (Windows 7)

Versi 1.9 menambahkan fungsionalitas berikut:

• Kemajuan penerusan yang dijamin untuk antrean I/O

• Dukungan untuk mengantre ulang permintaan I/O dari antrean I/O perangkat anak ke antrean I/O perangkat induk

• Kemampuan untuk menentukan sinkronisasi tingkat antrean untuk objek antrean individual.

• Metode berikut:

  • WdfDeviceGetSystemPowerAction
  • WdfDeviceRemoveDependentUsageDeviceObject
  • WdfInterruptSetExtendedPolicy
  • WdfPdoInitAllowForwardingRequestToParent
  • WdfPdoInitAssignContainerID
  • WdfPreDeviceInstallEx
  • WdfRequestForwardToParentDeviceIoQueue
  • WdfRequestMarkCancelableEx

• Menambahkan anggota NumberOfPresentedRequests ke struktur WDF_IO_QUEUE_CONFIG sehingga driver dapat membatasi jumlah permintaan I/O yang dikirimkan kerangka kerja ke driver dari antrean I/O paralel.

• Menambahkan bendera WdfFileObjectCanBeOptional ke struktur WDF_FILEOBJECT_CLASS.

• Menambahkan anggota TolerableDelay ke struktur WDF_TIMER_CONFIG.

• Menambahkan nilai registri WdfDefaultIdleInWorkingState dan WdfDefaultWakeFromSleepState .

KMDF 1.7 (Windows Vista dengan Paket Layanan 1; Windows Server 2008)

• Metode WdfDeviceEnqueueRequest dapat dipanggil di IRQL<=DISPATCH_LEVEL.

• Metode WdfWorkItemEnqueue dapat dipanggil jika item kerja yang ditentukan sudah ada di antrean item kerja.

• Menambahkan fungsi panggilan balik peristiwa EvtDeviceArmWakeFromSxWithReason.

• Menambahkan anggota ArmForWakeIfChildrenAreArmedForWake dan IndicateChildWakeOnParentWake ke struktur WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS .

KMDF 1.5 (Windows Vista)

• WdfUsbInterfaceGetNumSettings

• Menambahkan anggota DriverPoolTag ke WDF_DRIVER_CONFIG.

KMDF 1.1 (tidak dirilis dalam versi Windows)

• Metode berikut:
  • WdfCommonBufferCreateWithConfig
  • WdfDmaEnablerGetFragmentLength
  • WdfDmaEnablerWdmGetDmaAdapter

KMDF 1.0 (tidak dirilis dalam versi Windows)

Rilis awal.