KMDF-versiegeschiedenis

Dit onderwerp bevat versies van Kernel-Mode Driver Framework (KMDF), de bijbehorende versies van het Windows-besturingssysteem en de wijzigingen die in elke release zijn aangebracht.

In de volgende tabel ziet u de releasegeschiedenis van de KMDF-bibliotheek. U kunt de In dit artikel zijbalk aan de rechterkant gebruiken om snel naar een specifieke versie te navigeren.

U kunt de Windows Driver Kit (WDK) gebruiken met Microsoft Visual Studio 2022 om stuurprogramma's te bouwen die worden uitgevoerd op Windows 10 en hoger.

Zie Welke frameworkversie moet ik gebruiken voor hulp bij het bepalen van welke versie van WDF?.

Zie Samenvatting van WDF-callbacks en -methoden voor een volledige lijst met callbacks en methoden en op welke frameworks en versies ze van toepassing zijn.

Zie Wat is er nieuw voor WDF-stuurprogramma's voor informatie over de nieuwe functies voor KMDF-stuurprogramma's in Windows 10.

Voor elke sectie met KMDF-versies hieronder wordt de Windows-versie waarin deze is uitgebracht weergegeven tussen haakjes.

Nieuwste versie - KMDF 1.33 (Windows 11, versie 21H2; Windows Server 2022)

• Voor apparaten die SystemManagedIdleTimeout of SystemManagedIdleTimeoutWithHint opgeven in de opsomming WDF_POWER_POLICY_IDLE_TIMEOUT_TYPE, wanneer de macro WdfDeviceStopIdle wordt aangeroepen met WaitForD0 ingesteld op Onwaar, als het apparaat zich nog in D0 bevindt en de time-outperiode voor inactiviteit nog niet is verstreken, geeft WdfDeviceStopIdle STATUS_SUCCESS terug (in eerdere versies resulteerde dit in een waarde van STATUS_PENDING).
• WDF_POWER_FRAMEWORK_SETTINGS structuur heeft twee nieuwe leden (PoFxDeviceFlags en DirectedPoFxEnabled).

KMDF 1.31 (Windows 10, versie 2004)

• Er is een nieuwe API-WdfDeviceSetDeviceInterfaceStateEx toegevoegd.
• Bestaande API-WdfDeviceGetSystemPowerAction verbeterd
• Nieuwe API WdfPdoInitRemovePowerDependencyOnParent toegevoegd
• Inleiding tot het Geregisseerd Power Management Framework

KMDF 1.29 (Windows 10, versie 1903)

Ongewijzigd ten opzichte van versie 1.25.

KMDF 1.27 (Windows 10, versie 1809)

Ongewijzigd vanaf versie 1.25.

KMDF 1.25 (Windows 10, versie 1803)

• Een WDF-stuurprogramma bouwen voor meerdere versies van Windows.

KMDF 1.23 (Windows 10, versie 1709)

• Aanvullende functionaliteit toegevoegd voor intern gebruik. Zie Wdfcompanion.h voor meer informatie.

KMDF 1.21 (Windows 10, versie 1703)

• WdfFileObjectGetInitiatorProcessId was voorheen alleen UMDF, nu beschikbaar in KMDF.
• WdfRequestGetRequestorProcessId was voorheen alleen UMDF, nu beschikbaar in KMDF.
• WdfObjectDereferenceActual-: het type parameter File is gewijzigd van PCHAR naar PCCH.
• WdfObjectReferenceActual-: Het type van parameter Bestand is gewijzigd van PCHAR naar PCCH.
• WDF-registerwaarden ObjectLeakDetectionLimit en ObjectsForLeakDetection toegevoegd voor het debuggen van overmatige objectcreatie. Zie Registerwaarden voor foutopsporing van WDF-stuurprogramma'svoor meer informatie.
• Het hulpprogramma SleepStudy-software rapporteert het aantal energieverwijzingen dat een KMDF-stuurprogramma heeft die verhinderen dat het systeem in slaapstand gaat. Zie Modern stand-by SleepStudy voor meer informatie.

KMDF 1.19 (Windows 10, versie 1607)

• Toegevoegd WdfDmaTransactionSetSingleTransferRequirement
• Vlag WDF_DMA_ENABLER_CONFIG_REQUIRE_SINGLE_TRANSFER toegevoegd aan WDF_DMA_ENABLER_CONFIG_FLAGS
• STATUS_WDF_TOO_MANY_TRANSFERS retourwaarde toegevoegd voor WdfDmaTransactionInitialize en WdfDmaTransactionDmaCompleted
• Uitvoerberichten voor een enkele overdrachtsuitvoer toegevoegd aan !wdfkd.wdfdmatransaction en !wdfkd.wdfdmaenabler
• Zie DMA met één overdracht gebruiken voor meer informatie over DMA met één overdracht.

KMDF 1.15 (Windows 10, versie 1507)

• Met de nieuwe WdfDeviceOpenDevicemapKey methode kan een stuurprogramma toegang krijgen tot subsleutels en waarden onder HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP.
• WDF-broncode is openbaar beschikbaar via Windows Driver Frameworks. De persoonlijke symboolbestanden voor WDF zijn beschikbaar via de Microsoft Symbol Server. Zie ook Foutopsporing met WDF-bron en Video: Fouten opsporen in uw stuurprogramma met WDF-broncode.
• Inflight Trace Recorder (IFR) nu beschikbaar. Houd er rekening mee dat dit gescheiden is van de gebeurtenislogboekregistratie van het framework. Zie voor meer informatie Inflight Trace Recorder (IFR) voor het vastleggen van traceringen en het gebruik van de Inflight Trace Recorder in KMDF- en UMDF-stuurprogramma's.
• Ondersteuning voor interrupts voor door GPIO ondersteunde apparaten. Zie Een interruptobject makenvoor meer informatie.

KMDF 1.13 (Windows 8.1)

KMDF versie 1.13 voegt de volgende functionaliteit toe:

• CanWakeDevice lid toegevoegd aan WDF_INTERRUPT_CONFIG structuur ter ondersteuning van interrupts die kunnen worden gebruikt om een apparaat terug te brengen van een dx-status met weinig vermogen naar de volledige D0-status. Zie Een Interrupt Gebruiken om een Apparaat te Wekkenvoor meer informatie.
• Ondersteuning voor timers met een hoge resolutie. Voor meer informatie, zie Timers gebruiken.
• Ondersteuning voor timers die het systeem niet wakker maken als ze verlopen wanneer het systeem een lage energiestatus heeft. Voor meer informatie, zie Timers gebruiken.
• De volgende KMDF-/UMDF-methoden die worden beschreven in Accessing the Unified Device Property Model:
  • WdfDeviceAllocAndQueryPropertyEx
  • WdfDeviceAssignProperty
  • WdfDeviceInitSetIoTypeEx
  • WdfDeviceQueryPropertyEx
  • WdfFdoInitAllocAndQueryPropertyEx
  • WdfFdoInitQueryPropertyEx

Zie UMDF-versiegeschiedenis voor meer informatie over UMDF-versies.

KMDF 1.11 (Windows 8)

Versie 1.11 voegt de volgende functionaliteit toe:

• DMA in systeemmodus

• Ondersteuning voor passieve interrupts

• Functionele energiestatussen voor meerdere onderdelen binnen één apparaat

• IRP's naar I/O-wachtrijen verzenden

• De volgende methoden:

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

• EvtDeviceUsageNotificationEx toegevoegd.

• IdleTimeoutType en ExcludeD3Cold-elementen toegevoegd aan WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS.

• ReportInactiveOnPowerDown-element toegevoegd aan WDF_INTERRUPT_CONFIG.

• WdfIoTargetPurged-waarde toegevoegd aan WDF_IO_TARGET_STATE.

• WdfSpecialFileBoot-waarde toegevoegd aan WDF_SPECIAL_FILE_TYPE.

• DbgWaitForSignalTimeoutInSec toegevoegd aan registerwaarden voor framework-gebaseerde stuurprogramma's.

• Voorbeelden van InstallWdf, MultiComp en SingleComp zijn toegevoegd.

KMDF 1.9 (Windows 7)

Versie 1.9 voegt de volgende functionaliteit toe:

• Gegarandeerde voortgang voor I/O-wachtrijen

• Ondersteuning voor het opnieuw in de wachtrij plaatsen van I/O-aanvragen van de I/O-wachtrij van een kindapparaat naar de I/O-wachtrij van een bovenliggend apparaat

• Mogelijkheid om synchronisatie op wachtrijniveau op te geven voor afzonderlijke wachtrijobjecten.

• De volgende methoden:

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

• Het lid NumberOfPresentedRequests is toegevoegd aan de WDF_IO_QUEUE_CONFIG-structuur , zodat stuurprogramma's het aantal I/O-aanvragen kunnen beperken dat het framework aan het stuurprogramma levert vanuit een parallelle I/O-wachtrij.

• De vlag WdfFileObjectCanBeOptional is toegevoegd aan de WDF_FILEOBJECT_CLASS-structuur .

• Het lid TolerableDelay toegevoegd aan de WDF_TIMER_CONFIG-structuur.

• WdfDefaultIdleInWorkingState en WdfDefaultWakeFromSleepState registerwaarden toegevoegd.

KMDF 1.7 (Windows Vista met Service Pack 1; Windows Server 2008)

• De methode WdfDeviceEnqueueRequest kan worden aangeroepen op IRQL<=DISPATCH_LEVEL.

• De methode WdfWorkItemEnqueue kan worden aangeroepen als het opgegeven werkitem al in de werkitemwachtrij staat.

• De callback-functie evtDeviceArmWakeFromSxWithReason toegevoegd.

• ArmForWakeIfChildrenAreArmedForWake en IndicateChildWakeOnParentWake leden toegevoegd aan de WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS structuur.

KMDF 1.5 (Windows Vista)

• WdfUsbInterfaceGetNumSettings

• Het DriverPoolTag-lid toegevoegd aan WDF_DRIVER_CONFIG.

KMDF 1.1 (niet uitgebracht in een Windows-versie)

• De volgende methoden:
  • WdfCommonBufferCreateWithConfig
  • WdfDmaEnablerGetFragmentLength
  • WdfDmaEnablerWdmGetDmaAdapter

KMDF 1.0 (niet uitgebracht in een Windows-versie)

Eerste versie.