UMDF Sürüm Geçmişi

Bu konuda, User-Mode Driver Framework (UMDF) sürümleri, Windows işletim sisteminin karşılık gelen sürümleri ve her sürümde yapılan değişiklikler listelenmektedir.

Aşağıdaki tabloda UMDF kitaplığının yayın geçmişi gösterilmektedir. Bu makalede sağ taraftaki yan paneli kullanarak belirli bir sürüme hızla gidebilirsiniz.

UMDF sürümü	İlk sürüm	Dahil edilenler	Bu UMDF sürümünü kullanan sürücüler üzerinde çalışır
2.33	Windows 11, sürüm 21H2 WDK; Windows Server 2022 için WDK	Windows 11, sürüm 24H2; Windows 11, sürüm 23H2; Windows 11, sürüm 22H2; Windows 11, sürüm 21H2; Windows Server 2022	Windows 11, sürüm 21H2 ve üzeri; Windows Server 2022 ve üzeri
2.31	Windows 10, sürüm 2004 WDK	Windows 10, sürüm 2004 (Mayıs 2020 Güncelleştirmesi, Vibranium)	Windows 10, sürüm 2004 ve üzeri
Kategori 2.29	WDK'de yayımlanmadı	Windows 10, sürüm 1903 (Mart 2019 Güncelleştirmesi, 19H1)	Windows 10, sürüm 1903 ve üzeri
2,27	Windows 10, sürüm 1809 WDK	Windows 10, sürüm 1809 (Ekim 2018 Güncelleştirmesi, Redstone 5)	Windows 10, sürüm 1809 ve üzeri
2,25	Windows 10, sürüm 1803 WDK	Windows 10, sürüm 1803 (Nisan 2018 Güncelleştirmesi, Redstone 4)	Windows 10, sürüm 1803 ve üzeri
2.23	Windows 10, sürüm 1709 WDK	Windows 10, sürüm 1709 (Fall Creators Update, Redstone 3)	Windows 10, sürüm 1709 ve üzeri
2.21	Windows 10, sürüm 1703 WDK	Windows 10, sürüm 1703 (Creators Update, Redstone 2)	Windows 10, sürüm 1703 ve üzeri
2.19	Windows 10, sürüm 1607 WDK	Windows 10, sürüm 1607 (Yıldönümü Güncelleştirmesi, Redstone 1)	Windows 10, sürüm 1607, Windows Server 2016 ve üzeri
2.17	Windows 10, sürüm 1511 WDK	Windows 10, sürüm 1511 (Kasım Güncelleştirmesi, Eşik 2)	Windows 10, sürüm 1511, Windows Server 2016 ve üzeri
2.15	Windows 10 Sürücü Kiti (WDK)	Windows 10, sürüm 1507 (Eşik 1)	Windows 10, sürüm 1507, Windows Server 2016 ve üzeri
2.0	Windows Sürücü Seti (WDK) 8.1	Windows 8.1	Windows 8.1 ve sonrası
1.11	Windows Sürücü Seti (WDK) 8	Windows 8	Windows Vista ve üzeri
1.9	Windows 7 Sürücü Geliştirme Kiti	Windows 7	Windows XP ve üzeri
1.7	Windows Server 2008 WDK	Windows Vista Service Pack 1 (SP1), Windows Server 2008	Windows XP ve üzeri
1.5	Windows Vista Sürücü Kiti (WDK)	Windows Vista	Windows XP ve üzeri

Windows 10 ve sonraki sürümlerde çalışan sürücüler oluşturmak için Microsoft Visual Studio 2022 ile Windows Sürücü Seti'ni (WDK) kullanabilirsiniz.

Hangi WDF sürümünün kullanılacağını belirleme konusunda yardım için bkz. Hangi çerçeve sürümünü kullanmalıyım?.

Windows 10'da UMDF sürücülerinin yeni özellikleri hakkında bilgi için bkz. WDF Sürücüleri için Yenilikler.

Aşağıdaki her UMDF sürümü bölümü için, yayımlandığı Windows sürümü parantez içinde listelenir.

En son sürüm - UMDF 2.33 (Windows 11, sürüm 21H2; Windows Server 2022)

• WDF_POWER_POLICY_IDLE_TIMEOUT_TYPE numaralandırmasında SystemManagedIdleTimeout veya SystemManagedIdleTimeoutWithHint belirten cihazlar için, WdfDeviceStopIdle makrosunu çağırırken, WaitForD0FALSEolarak ayarlanmışsa, cihaz hala D0 içindeyse ve boşta kalma zaman aşımı süresi henüz dolmamışsa, WdfDeviceStopIdle STATUS_SUCCESS döndürür (önceki sürümlerde bu, STATUS_PENDING dönüş değerine neden oldu).
• WdfDeviceWdmAssignPowerFrameworkSettings işlevi artık UMDF'i destekliyor.
• WDF_POWER_FRAMEWORK_SETTINGS yapısı iki yeni üyeye (PoFxDeviceFlags ve DirectedPoFxEnabled) sahiptir ve artık UMDF ile kullanılabilir. UMDF için yalnızca Size, PoFxDeviceFlags ve DirectedPoFxEnabled üyeleri kullanılır. Diğer alanlar yoksayılır ve sıfır olarak ayarlanmalıdır. Bir UMDF sürücüsü WDF_POWER_FRAMEWORK_SETTINGS_INIT işlevini çağırdığında çerçeve bunu otomatik olarak yapar.

UMDF 2.31 (Windows 10, sürüm 2004)

• Yeni API WdfDeviceSetDeviceInterfaceStateEx eklendi
• Mevcut API WdfDeviceGetSystemPowerAction geliştirildi
• Sürücü başına HostProcessDbgBreakOnDriverLoad kayıt defteri değeri eklendi. Bilgi için bkz. WDF Sürücülerinde Hata Ayıklama için Kayıt Defteri Değerleri.
• Yönlendirilmiş Güç Yönetimi Çerçevesi Giriş

UMDF 2.29 (Windows 10, sürüm 1903)

Sürüm 2.27'den değişmedi.

UMDF 2.27 (Windows 10, sürüm 1809)

• Yeni API WdfDriverRetrieveDriverDataDirectoryString eklendi

UMDF 2.25 (Windows 10, sürüm 1803)

• WdfDeviceRetrieveDeviceDirectoryString
• Windows'in birden çok sürümü için WDF sürücüsü oluşturma.

UMDF 2.23 (Windows 10, sürüm 1709)

• Eşlikçi işlevselliği yalnızca iç kullanım için eklendi. Yeni DDI'ler için bkz. WDF Geri Çağırmalarının ve Yöntemlerinin Özeti.

UMDF 2.21 (Windows 10, sürüm 1703)

• WdfObjectDereferenceActual: PCHAR'dan PCCH'ye değiştirilen Dosya parametresinin türü.
• WdfObjectReferenceActual: PCHAR'dan PCCH'ye değiştirilen Dosya parametresinin türü.
• WDF kayıt defteri değerleri olan ObjectLeakDetectionLimit ve ObjectsForLeakDetection, aşırı nesne oluşturmayı ayıklamak için eklendi. Daha fazla bilgi için, WDF Sürücüleri Hata Ayıklama Kayıt Defteri Değerleri’ne bakınız .

UMDF 2.19 (Windows 10, sürüm 1607)

UMDF Sürüm 2.19 için değişiklik veya ekleme yoktur.

UMDF 2.17 (Windows 10, sürüm 1511)

Bu sürüm, aşağıdaki mevcut arabirimler için UMDF desteği ekler:

• WdfDeviceConfigureWdmIrpDispatchCallback
• EvtDeviceWdmIrpDispatch
• WdfDeviceWdmDispatchIrp
• WdfDeviceWdmDispatchIrpToIoQueue

Daha fazla bilgi için bkz. IRP'leri G/Ç Kuyruklarına Dağıtma.

UMDF 2.15 (Windows 10, sürüm 1507)

• Yeni WdfDeviceOpenDevicemapKey yöntemi, bir sürücünün HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAPaltındaki alt anahtarlara ve değerlere erişmesine olanak tanır.
• UMDF sürücüsü WdfIoTargetWdmGetTargetFileHandle'ı çağırarak yığınındaki sonraki düşük çekirdek modu sürücüsüne bir dosya tanıtıcısı alabilir. Sürücü, yerel G/Ç hedefine veri göndermek için çerçevenin soyutlamalarını atlayarak bu tanıtıcıya veri yazabilir.
• UMDF sürücüsü, temel alınan veri yolu sürücüsünün kendisini yeniden numaralandırmasını isteyebilir. Bkz. WdfDeviceSetFailed.
• Bağlantı kaynakları olan cihazlar için UmdfDirectHardwareAccess yönergesinin ayarlanması artık her zaman gerekli değildir. Bkz . INF Dosyalarında WDF Yönergelerini Belirtme.
• WDF kaynak kodu, Windows Sürücü Çerçeveleri'nden genel olarak kullanılabilir. WDF için özel sembol dosyaları Microsoft Sembol Sunucusu aracılığıyla kullanılabilir. Ayrıca bkz. WDF Kaynak ile Hata Ayıklama ve Video: WDF kaynak koduyla sürücünüzde hata ayıklama.
• Uçak İçi İzleme Kaydedicisi (IFR) artık kullanılabilir. Bunun çerçevesinin olay günlüğündenayrı olduğunu unutmayın. Daha fazla bilgi için bkz. Günlük İzleme Kaydedici (IFR) ile izlemeleri kaydetmek ve KMDF ve UMDF Sürücülerinde Uçuş İzleme Kaydedicisi Kullanımı.
• GPIO tabanlı cihazlar için kesme desteği. Daha fazla bilgi için bkz. Kesme Nesnesi Oluşturma.

UMDF 2.0 (Windows 8.1)

UMDF'yi Kullanmaya Başlama bölümünde açıklanan paylaşılan işlevlere ek olarak, UMDF sürüm 2.0 şunları ekler:

• Sistem düşük güç durumundayken süresi dolarsa sistemi uyandırmayan zamanlayıcılar için destek. Daha fazla bilgi için bkz. Zamanlayıcıları kullanma.

• CanWakeDevice üyesi, cihazı düşük güçteki Dx durumundan tamamen çalışır D0 durumuna geri getirebilecek kesmeleri desteklemek amacıyla WDF_INTERRUPT_CONFIG yapısına eklenmiştir. Daha fazla bilgi için bkz. Bir Cihazı Uyandırmak için Kesme Kullanma.

• UMDF sürücüleri için tek bileşenli, tek durumlu (F0) güç yönetimi. Daha fazla bilgi için WdfDeviceAssignS0IdleSettings'ye bakın.

• Wdfkd.dll'deki çeşitli hata ayıklayıcısı uzantısı komutları artık UMDF 2.0 sürücüleri için de kullanılabilir. Uzantı kitaplığı, UMDF 2.0 sürücülerinin hatalarını ayıklamak için özel olarak tasarlanmış aşağıdaki yeni uzantı komutlarını da içerir:

  • !wdfkd.wdfumdevstack

  • !wdfkd.wdfumdevstacks

  • !wdfkd.wdfumdownirp

  • !wdfkd.wdfumfile

  • !wdfkd.wdfumirp

  • !wdfkd.wdfumirps

  • !wdfkd.wdfdeviceinterrupts

    Uzantı komutlarının ve çerçeve uygulanabilirliğinin listesi için bkz. Hata Ayıklayıcı Uzantıları.

• Çerçevenin olay günlükçüsüsü veya In-flight Recorder (IFR), UMDF 2.0 sürücüleri için çalışacak şekilde güncelleştirildi.

• Diğer WDF hata ayıklayıcısı uzantıları UMDF 2.0 sürücüleriyle çalışacak şekilde güncelleştirildi. Hangilerinin hangi çerçeve için geçerli olduğu hakkında bilgiler de dahil olmak üzere uzantı komutlarının tam listesi için bkz. WDF Sürücüleri için Hata Ayıklayıcı Uzantıları.

• UMDF sürücülerinin sürücü tarafından oluşturulan istekleri ilişkili dosya nesnesi gerektiren alt hedeflere göndermesine izin vermek için WDF_IO_TARGET_OPEN_TYPEWdfIoTargetOpenLocalTargetByFile eklendi. Daha fazla bilgi için bkz. WDF_IO_TARGET_OPEN_TYPE Açıklamaları.

• Aşağıdaki yalnızca UMDF işlevleri:

  • EvtRequestImpersonate
  • WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_FILE
  • WdfDeviceAllocAndQueryInterfaceProperty
  • WdfDeviceAssignInterfaceProperty
  • WdfDeviceGetDeviceStackIoType
  • WdfDeviceGetHardwareRegisterMappedAddress
  • WdfDeviceMapIoSpace
  • WdfDevicePostEvent
  • WdfDeviceQueryInterfaceProperty
  • WdfDeviceUnmapIoSpace
  • WdfFileObjectGetInitiatorProcessId (KMDF 1.21'e eklendi)
  • WdfFileObjectGetRelatedFileObject
  • WdfRequestGetEffectiveIoType
  • WdfRequestGetRequestorProcessId (KMDF 1.21'e eklendi)
  • WdfRequestGetUserModeInitiatedIo
  • WdfRequestImpersonate
  • WdfRequestIsFromUserModeDriver
  • WdfRequestRetrieveActivityId
  • WdfRequestSetActivityId
  • WdfRequestSetUserModeDriverInitiatedIo

• Birleşik Cihaz Özellik Modeline Erişme bölümünde açıklanan aşağıdaki KMDF/UMDF yöntemleri:

  • WdfDeviceAllocAndQueryPropertyEx

  • WdfDeviceAssignProperty

  • WdfDeviceInitSetIoTypeEx

  • WdfDeviceQueryPropertyEx

  • WdfFdoInitAllocAndQueryPropertyEx

  • WdfFdoInitQueryPropertyEx

    Daha fazla bilgi için bkz. Birleşik Cihaz Özellik Modeline Erişme.

• WdfUsbTargetDeviceSelectConfigType'da aşağıdaki USB yapılandırma türleri için destek:

  • WdfUsbTargetDeviceSelectConfigTypeSingleInterface
  • WdfUsbTargetDeviceSelectConfigTypeMultiInterface
  • WdfUsbTargetDeviceSelectConfigTypeInterfacesPairs

• WdfUsbTargetDeviceQueryUsbCapability'da aşağıdaki özellik türlerini sorgulama desteği:

  • GUID_USB_CAPABILITY_DEVICE_CONNECTION_HIGH_SPEED_COMPATIBLE
  • GUID_USB_CAPABILITY_DEVICE_CONNECTION_SUPER_SPEED_COMPATIBLE

• WDF Yazmaç/Bağlantı Noktası Erişim İşlevleri eklendi

UMDF 1.11 (Windows 8)

Sürüm 1.11, sürücü tarafından sağlanan aşağıdaki geri çağırma arabirimlerini ve olay geri çağırma işlevlerini ekler:

• IPnpCallbackHardware2

• IPnpCallbackHardwareInterrupt

Sürüm 1.11 aşağıdaki çerçeve tarafından sağlanan arabirimleri ekler:

• IWDFCmResourceList

• IWDFDevice3

• IWDFFile3

• IWDFInterrupt

• IWDFIoRequest3

• IWDFUnifiedPropertyStore

• IWDFUnifiedPropertyStoreFactory

• IWDFWorkItem

Sürüm 1.11, UMDF tabanlı sürücülere aşağıdaki özellikleri ekler:

• Donanıma Erişme ve Kesmeleri İşleme

• UMDF Sürücülerinde Cihaz Havuzu Kullanma

• INF Dosyalarında WDF Yönergelerini Belirtme bölümünde açıklanan UmdfHostProcessSharing, UmdfDirectHardwareAccess, UmdfRegisterAccessMode, UmdfFileObjectPolicy ve UmdfFsContextUsePolicy yönergeleri eklendi

• UMDF sürücüleri için iyi bilinen güvenlik tanımlayıcıları (SID)

• UMDF Tabanlı Sürücülerde Kayıt Defterini Kullanma bölümünde açıklanan Birleşik özellik deposu desteği

• IoGetDeviceObjectPointer , UMDF ile çalışacak şekilde tümleşiktir. Önceki sürümlerde, bu yordam, cihaz nesnesinin tutamacında bir başvuru aldıktan sonra cihaz nesnesine olan tutamacı kapatır. Bu davranış, UMDF'nin cihaz nesnesindeki temizleme isteğinin tüm G/Ç tamamlanana kadar gerçekleşmeyeceği beklentisiyle uyumsuzdu.

• UMDF tabanlı HID MiniDriver oluşturma

• UMDF tabanlı sürücülerde Idle Power-Down desteğine yönelik geliştirilmiş destek. Çerçeve artık boşta kalma zaman aşımı süresi dolduğunda cihazı D3cold güç durumuna alabilir. Çerçeve, sistem çalışma (S0) durumuna döndüğünde cihazın çalışma (D0) durumuna dönmesine de neden olabilir.

• UmDF 1.11'de aşağıdaki örnekler yenidir: WudfVhidmini, NetNfpProvider.

UMDF 1.9 (Windows 7)

Sürüm 1.9, sürücü tarafından sağlanan aşağıdaki geri arama arabirimlerini ekler:

• IPnpCallbackRemoteInterfaceNotification

• IPowerPolicyCallbackWakeFromS0

• IPowerPolicyCallbackWakeFromSx

• IQueueCallbackIoCanceledOnQueue

• IRemoteInterfaceCallbackEvent

• IRemoteInterfaceCallbackRemoval

• IRemoteTargetCallbackRemoval

• IWDFRemoteInterfaceInitialize

Sürüm 1.9 aşağıdaki çerçeve tarafından sağlanan arabirimleri ekler:

• IWDFDevice2

• IWDFDeviceInitialize2

• IWDFFile2

• IWDFIoRequest2

• IWDFIoTarget2

• IWDFNamedPropertyStore2

• IWDFPropertyStoreFactory

• IWDFRemoteTarget

• IWDFUsbTargetPipe2

Bu arabirimler UMDF tabanlı sürücülere aşağıdaki özellikleri ekler:

• Uzak G/Ç hedefleri

• Enerji politikası sahipliği

• Doğrudan Girdi/Çıktı arabellek erişim yöntemi

• USB cihazları için sürekli okuyucular

• Cihaz arabirimleri için gelişmiş destek

• G/Ç isteklerini iptal etme özelliği geliştirildi

• Kayıt defterine gelişmiş erişim