Histórico de versão do KMDF

Artigo
01/10/2024

Este tópico lista versões do KMDF (Kernel-Mode Driver Framework), as versões correspondentes do sistema operacional Windows e as alterações feitas em cada versão.

A tabela a seguir mostra o histórico de lançamento da biblioteca KMDF. Você pode usar a barra lateral Neste artigo à direita para navegar rapidamente até uma versão específica.

Versão do KMDF	Versão inicial	Incluído em	Drivers que usam essa versão kmdf são executados em
1.33	Windows 11, versão 21H2 WDK; WDK para Windows Server 2022	Windows 11, versão 23H2; Windows 11, versão 22H2; Windows 11, versão 21H2; Windows Server 2022	Windows 11, versão 21H2 e posterior; Windows Server 2022 e posterior
1.31	Windows 10, versão 2004 WDK	Windows 10, versão 2004	Windows 10, versão 2004 e posterior
1.29	Não lançado no WDK	Windows 10, versão 1903	Windows 10 versão 1903 e posterior
1.27	WDK do Windows 10, versão 1809	Windows 10, versão 1809	Windows 10 versão 1809 e posterior
1,25	Windows 10, versão 1803 WDK	Windows 10, versão 1803	Windows 10 versão 1803 e posterior
1.23	Windows 10, versão 1709 WDK	Windows 10, versão 1709	Windows 10, versão 1709 e posterior
1.21	Windows 10, versão 1703 WDK	Windows 10, versão 1703	Windows 10 versão 1703 e posterior
1,19	Windows 10, versão 1607 WDK	Windows 10, versão 1607	Windows 10 versão 1607, Windows Server 2016 e posterior
1.17	Windows 10, versão 1511 WDK	Windows 10, versão 1511	Windows 10 versão 1511, Windows Server 2016 e posterior
1.15	WDK do Windows 10	Windows 10, versão 1507	Windows 10, versão 1507, Windows Server 2016 e posterior
1.13	WDK do Windows 8.1	Windows 8.1	Windows 8.1 e posterior
1.11	WDK do Windows 8	Windows 8	Windows Vista e posterior
1,9	Windows 7 WDK	Windows 7	Windows XP e posterior
1.7	Windows Server 2008 WDK	Windows Vista com Service Pack 1 (SP1); Windows Server 2008	Windows 2000 e posterior
1.5	Windows Vista WDK	Windows Vista	Windows 2000 e posterior
1,1	Somente download	Nenhum	Windows 2000 e posterior
1.0	Somente download	Nenhum	Windows XP e posterior

Você pode usar o WDK (Kit de Driver do Windows) com o Microsoft Visual Studio 2019 para criar drivers executados em Windows 10 e posteriores.

Para obter ajuda para determinar qual versão do WDF usar, consulte Qual versão da estrutura devo usar?.

Para obter uma lista completa de retornos de chamada e métodos e a quais estruturas e versões elas se aplicam, consulte Resumo dos métodos e retornos de chamada do WDF.

Para obter informações sobre os novos recursos para drivers KMDF no Windows 10, consulte Novidades para drivers WDF.

Para cada seção de versão do KMDF abaixo, a versão do Windows na qual ela foi lançada está listada entre parênteses.

Versão mais recente – KMDF 1.33 (Windows 11, versão 21H2; Windows Server 2022)

Para dispositivos que especificam SystemManagedIdleTimeout ou SystemManagedIdleTimeoutWithHint na enumeração WDF_POWER_POLICY_IDLE_TIMEOUT_TYPE , ao chamar a macro WdfDeviceStopIdle com WaitForD0 definido como FALSE, se o dispositivo ainda estiver em D0 e o período de tempo limite ocioso ainda não tiver decorrido, WdfDeviceStopIdle retornará STATUS_SUCCESS (em versões anteriores isso resultou em um valor retornado de STATUS_PENDING).
WDF_POWER_FRAMEWORK_SETTINGS estrutura tem dois novos membros (PoFxDeviceFlags e DirectedPoFxEnabled).

KMDF 1.31 (Windows 10, versão 2004)

Adicionada nova API WdfDeviceSetDeviceInterfaceStateEx
API existente aprimorada WdfDeviceGetSystemPowerAction
Adicionada nova API WdfPdoInitRemovePowerDependencyOnParent
Introdução à estrutura de gerenciamento de energia direcionada

KMDF 1.29 (Windows 10, versão 1903)

Inalterado da versão 1.25.

KMDF 1.27 (Windows 10, versão 1809)

Inalterado da versão 1.25.

KMDF 1.25 (Windows 10, versão 1803)

Criando um driver WDF para várias versões do Windows.

KMDF 1.23 (Windows 10, versão 1709)

Funcionalidade complementar adicionada somente para uso interno. Para obter mais informações, consulte Wdfcompanion.h.

KMDF 1.21 (Windows 10, versão 1703)

WdfFileObjectGetInitiatorProcessId era anteriormente somente UMDF, agora disponível no KMDF.
WdfRequestGetRequestorProcessId era anteriormente somente UMDF, agora disponível no KMDF.
WdfObjectDereferenceActual: tipo de parâmetro File alterado de PCHAR para PCCH.
WdfObjectReferenceActual: tipo de parâmetro File alterado de PCHAR para PCCH.
Os valores de registro do WDF ObjectLeakDetectionLimit e ObjectsForLeakDetection foram adicionados para depurar a criação excessiva de objetos. Para obter mais informações, consulte Valores do Registro para depuração de drivers WDF.
A ferramenta de software SleepStudy relata o número de referências de energia que um driver KMDF tem que estão impedindo que o sistema entre em suspensão. Para obter mais informações, consulte SleepStudy em espera moderno.

KMDF 1.19 (Windows 10, versão 1607)

WdfDmaTransactionSetSingleTransferRequirement adicionado
Adição do sinalizador de WDF_DMA_ENABLER_CONFIG_REQUIRE_SINGLE_TRANSFER no WDF_DMA_ENABLER_CONFIG_FLAGS
Adicionado STATUS_WDF_TOO_MANY_TRANSFERS valor retornado para WdfDmaTransactionInitialize e WdfDmaTransactionDmaCompleted
Adicionadas mensagens de saída para saída de transferência única a !wdfkd.wdfdmatransaction e !wdfkd.wdfdmaenabler
Para obter mais informações sobre o AMD de transferência única, consulte Usando o DMA de transferência única.

KMDF 1.15 (Windows 10, versão 1507)

O novo método WdfDeviceOpenDevicemapKey permite que um driver acesse subchaves e valores em HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP.
O código-fonte do WDF está disponível publicamente nas Estruturas de Driver do Windows. Os arquivos de símbolo privado para WDF estão disponíveis por meio do Servidor de Símbolos da Microsoft. Confira também Depuração com o código-fonte e vídeo do WDF : depurando seu driver com o código-fonte do WDF.
O INflight Trace Recorder (IFR) já está disponível. Observe que isso é separado do agente de eventos da estrutura. Para obter mais informações, consulte IfR (Gravador de Rastreamento de Bordo) para registrar rastreamentos em log e Usando o Gravador de Rastreamento de Voo em Drivers KMDF e UMDF.
Suporte para interrupções para dispositivos com suporte de GPIO. Para obter mais informações, consulte Criando um objeto interrupto.

KMDF 1.13 (Windows 8.1)

O KMDF versão 1.13 adiciona a seguinte funcionalidade:

Adicionado o membro CanWakeDevice à estrutura WDF_INTERRUPT_CONFIG para dar suporte a interrupções que podem ser usadas para trazer um dispositivo de um estado Dx de baixa potência de volta para seu estado totalmente em D0. Para obter mais informações, consulte Usando uma interrupção para ativar um dispositivo.
Suporte para temporizadores de alta resolução. Para obter mais informações, consulte Usando temporizadores.
Suporte para temporizadores que não ativam o sistema se expirarem quando o sistema estiver em um estado de baixa potência. Para obter mais informações, consulte Usando temporizadores.
Os seguintes métodos KMDF/UMDF descritos em Acessando o modelo de propriedade de dispositivo unificado:

Para obter informações sobre as versões do UMDF, consulte Histórico de versões do UMDF.

KMDF 1.11 (Windows 8)

A versão 1.11 adiciona a seguinte funcionalidade:

AMD do modo de sistema
Suporte para interrupções de nível passivo
Estados de energia funcional para vários componentes em um único dispositivo
Expedindo IRPs para filas de E/S
Os seguintes métodos:
EvtDeviceUsageNotificationEx foi adicionado.
Os membros IdleTimeoutType e ExcludeD3Cold foram adicionados a WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS.
Adicionado membro ReportInactiveOnPowerDown ao WDF_INTERRUPT_CONFIG.
O valor WdfIoTargetPurged foi adicionado a WDF_IO_TARGET_STATE.
O valor de WdfSpecialFileBoot foi adicionado a WDF_SPECIAL_FILE_TYPE.
DbgWaitForSignalTimeoutInSec foi adicionado aos valores do Registro para depuração de drivers baseados em estrutura.
Foram adicionados exemplos de InstallWdf, MultiComp e SingleComp .

KMDF 1.9 (Windows 7)

A versão 1.9 adiciona a seguinte funcionalidade:

Progresso de encaminhamento garantido para filas de E/S
Suporte para requeuing de solicitações de E/S da fila de E/S de um dispositivo filho para a fila de E/S de um dispositivo pai
Capacidade de especificar a sincronização no nível da fila para objetos de fila individuais.
Os seguintes métodos:
Adicionado o membro NumberOfPresentedRequests à estrutura WDF_IO_QUEUE_CONFIG para que os drivers possam limitar o número de solicitações de E/S que a estrutura fornece ao driver de uma fila de E/S paralela.
O sinalizador WdfFileObjectCanBeOptional foi adicionado à estrutura WDF_FILEOBJECT_CLASS .
Adicionado o membro TolerableDelay à estrutura WDF_TIMER_CONFIG .
Os valores de registro WdfDefaultIdleInWorkingState e WdfDefaultWakeFromSleepState foram adicionados.

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

O método WdfDeviceEnqueueRequest pode ser chamado em IRQL<=DISPATCH_LEVEL.
O método WdfWorkItemEnqueue poderá ser chamado se o item de trabalho especificado já estiver na fila do item de trabalho.
A função de retorno de chamada de evento EvtDeviceArmWakeFromSxWithReason foi adicionada.
Os membros ArmForWakeIfChildrenAreArmedForWake e IndicateChildWakeOnParentWake foram adicionados à estrutura WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS .

KMDF 1.5 (Windows Vista)

WdfUsbInterfaceGetNumSettings
Adicionado o membro DriverPoolTag ao WDF_DRIVER_CONFIG.

KMDF 1.1 (não lançado em uma versão do Windows)

Os seguintes métodos:

KMDF 1.0 (não lançado em uma versão do Windows)

Versão inicial.