Histórico de versões do UMDF

Artigo
06/13/2024

Este tópico lista as versões do UMDF (User-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 UMDF. Você pode usar a barra lateral Neste artigo à direita para navegar rapidamente para uma versão específica.

Versão UMDF	Versão inicial	Incluído em	Os drivers que usam esta versão UMDF são executados em
2.33	Windows 11, versão 21H2 WDK; WDK para Windows Server 2022	Windows 11, versão 24H2; 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
2,31	Windows 10, versão 2004 WDK	Windows 10, versão 2004 (Atualização de maio de 2020, Vibranium)	Windows 10, versão 2004 e posterior
2.29	Não lançado no WDK	Windows 10, versão 1903 (Atualização de março de 2019, 19H1)	Windows 10, versão 1903 e posterior
2.27	Windows 10, versão 1809 WDK	Windows 10, versão 1809 (Atualização de outubro de 2018, Redstone 5)	Windows 10 versão 1809 e posterior
2.25	Windows 10, versão 1803 WDK	Windows 10, versão 1803 (Atualização de abril de 2018, Redstone 4)	Windows 10, versão 1803 ou posterior.
2.23	Windows 10, versão 1709 WDK	Windows 10, versão 1709 (Fall Creators Update, Redstone 3)	Windows 10, versão 1709 e posterior
2.21	Windows 10, versão 1703 WDK	Windows 10, versão 1703 (Creators Update, Redstone 2)	Windows 10, versão 1703 e posterior
2.19	Windows 10, versão 1607 WDK	Windows 10, versão 1607 (Atualização de aniversário, Redstone 1)	Windows 10, versão 1607, Windows Server 2016 e posterior
2.17	Windows 10, versão 1511 WDK	Windows 10, versão 1511 (Atualização de novembro, Limiar 2)	Windows 10, versão 1511, Windows Server 2016 e posterior
2.15	Windows 10 WDK	Windows 10, versão 1507 (Limiar 1)	Windows 10, versão 1507, Windows Server 2016 e posterior
2,0	Kit de Driver do Windows (WDK) 8.1	Windows 8.1	Windows 8.1 e posterior
1.11	Kit de Driver do Windows (WDK) 8	Windows 8	Windows Vista e superior
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 XP e posterior
1.5	Windows Vista WDK	Windows Vista	Windows XP e posterior

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

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

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

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

Última versão - UMDF 2.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 de retorno de STATUS_PENDING).
A função WdfDeviceWdmAssignPowerFrameworkSettings agora oferece suporte a UMDF.
WDF_POWER_FRAMEWORK_SETTINGS estrutura tem dois novos membros (PoFxDeviceFlags e DirectedPoFxEnabled) e agora pode ser usada com UMDF. Para UMDF, somente os membros Size, PoFxDeviceFlags e DirectedPoFxEnabled são usados. Outros campos são ignorados e devem ser definidos como zero. A estrutura faz isso automaticamente quando um driver UMDF chama a função WDF_POWER_FRAMEWORK_SETTINGS_INIT.

UMDF 2.31 (Windows 10, versão 2004)

Adicionada nova API WdfDeviceSetDeviceInterfaceStateEx
API existente aprimorada WdfDeviceGetSystemPowerAction
Adicionado valor de registro HostProcessDbgBreakOnDriverLoad por driver. Para obter informações, consulte Valores do Registro para depuração de drivers WDF.
Introdução à estrutura de gerenciamento de energia direcionada

UMDF 2.29 (Windows 10, versão 1903)

Inalterado a partir da versão 2.27.

UMDF 2.27 (Windows 10, versão 1809)

Adicionada nova API WdfDriverRetrieveDriverDataDirectoryString

UMDF 2.25 (Windows 10, versão 1803)

UMDF 2.23 (Windows 10, versão 1709)

Funcionalidade complementar adicionada apenas para uso interno. Para obter as novas DDIs, consulte Resumo dos retornos de chamada e métodos do WDF.

UMDF 2.21 (Windows 10, versão 1703)

WdfObjectDereferenceActual: Tipo de parâmetro File alterado de PCHAR para PCCH.
WdfObjectReferenceActual: Tipo de parâmetro File alterado de PCHAR para PCCH.
Adicionados os valores de registro WDF ObjectLeakDetectionLimit e ObjectsForLeakDetection para depuração da criação excessiva de objetos. Para obter mais informações, consulte Valores do Registro para depuração de drivers WDF.

UMDF 2.19 (Windows 10, versão 1607)

Não há alterações ou adições para UMDF versão 2.19.

UMDF 2.17 (Windows 10, versão 1511)

Esta versão adiciona suporte UMDF para as seguintes interfaces existentes:

Para obter mais informações, consulte Despachando IRPs para filas de E/S.

UMDF 2.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.
Um driver UMDF pode chamar WdfIoTargetWdmGetTargetFileHandle para obter um identificador de arquivo para o próximo driver de modo kernel inferior em sua pilha. O driver pode gravar dados nesse identificador, ignorando as abstrações da estrutura para enviar E/S para o destino de E/S local.
Um driver UMDF pode solicitar que o driver de barramento subjacente o recensee. Consulte WdfDeviceSetFailed.
A definição da diretiva UmdfDirectHardwareAccess nem sempre é necessária para dispositivos que possuem recursos de conexão. Consulte Especificando diretivas WDF em arquivos INF.
O código-fonte do WDF está disponível publicamente no Windows Driver Frameworks. Os arquivos de símbolo privado para WDF estão disponíveis por meio do Microsoft Symbol Server. Consulte também Depurando com WDF Source e Vídeo: Depurando seu driver com o código-fonte WDF.
Inflight Trace Recorder (IFR) agora disponível. Observe que isso é separado do log de eventos da estrutura. Para obter mais informações, consulte Gravador de rastreamento a bordo (IFR) para registrar rastreamentos e Usando o gravador de rastreamento a bordo em drivers KMDF e UMDF.
Suporte para interrupções para dispositivos apoiados por GPIO. Para obter mais informações, consulte Criando um objeto de interrupção.

UMDF 2.0 (Windows 8.1)

Além da funcionalidade compartilhada descrita em Introdução ao UMDF, o UMDF versão 2.0 adiciona:

Suporte para temporizadores que não ativam o sistema se expirarem quando o sistema estiver em um estado de baixo consumo de energia. Para obter mais informações, consulte Usando temporizadores.
Membro CanWakeDevice adicionado à estrutura WDF_INTERRUPT_CONFIG para suportar interrupções que podem ser usadas para trazer um dispositivo de um estado Dx de baixo consumo de energia de volta ao seu estado totalmente em D0. Para obter mais informações, consulte Usando uma interrupção para ativar um dispositivo.
Gerenciamento de energia de componente único e estado único (F0) para drivers UMDF. Para obter mais informações, consulte WdfDeviceAssignS0IdleSettings.
Vários comandos de extensão do depurador no Wdfkd.dll agora também podem ser usados para drivers UMDF 2.0. A biblioteca de extensões também contém os seguintes novos comandos de extensão projetados especificamente para depuração de drivers UMDF 2.0:
- !wdfkd.wdfumdevstack
- !wdfkd.wdfumdevstacks
- !wdfkd.wdfumdownirp
- !wdfkd.wdfumfile
- !wdfkd.wdfumirp
- !wdfkd.wdfumirps
- !wdfkd.wdfdeviceinterrupts
  
  Para obter uma lista de comandos de extensão e aplicabilidade de estrutura, consulte Extensões do depurador.
O registrador de eventos da estrutura ou Gravador em Voo (IFR) foi atualizado para funcionar para drivers UMDF 2.0.
Outras extensões do depurador WDF foram atualizadas para funcionar com drivers UMDF 2.0. Para obter uma lista completa de comandos de extensão, incluindo informações sobre quais se aplicam a qual estrutura, consulte Extensões do depurador para drivers WDF.
WdfIoTargetOpenLocalTargetByFile adicionado ao WDF_IO_TARGET_OPEN_TYPE para permitir que os drivers UMDF enviem solicitações criadas por driver para destinos inferiores que exigem um objeto de arquivo associado. Para obter mais informações, consulte as Observações de WDF_IO_TARGET_OPEN_TYPE.
As seguintes rotinas somente UMDF:
Os seguintes métodos KMDF/UMDF descritos em Acessando o modelo de propriedade de dispositivo unificado:
- WdfDeviceAllocAndQueryPropertyEx
- WdfDeviceAssignProperty
- WdfDeviceInitSetIoTypeEx
- WdfDeviceQueryPropertyEx
- WdfFdoInitAllocAndQueryPropertyEx
- WdfFdoInitQueryPropertyEx
  
  Para obter mais informações, consulte Acessando o modelo de propriedade de dispositivo unificado.
Suporte para os seguintes tipos de configuração USB em WdfUsbTargetDeviceSelectConfigType:
- WdfUsbTargetDeviceSelectConfigTypeSingleInterface
- WdfUsbTargetDeviceSelectConfigTypeMultiInterface
- WdfUsbTargetDeviceSelectConfigTypeInterfacesPairs
Suporte para consultar os seguintes tipos de recursos em WdfUsbTargetDeviceQueryUsbCapability:
- GUID_USB_CAPABILITY_DEVICE_CONNECTION_HIGH_SPEED_COMPATIBLE
- GUID_USB_CAPABILITY_DEVICE_CONNECTION_SUPER_SPEED_COMPATIBLE
Adicionadas funções de registro/acesso à porta WDF

UMDF 1.11 (Windows 8)

A versão 1.11 adiciona as seguintes interfaces de retorno de chamada fornecidas pelo driver e funções de retorno de chamada de evento:

A versão 1.11 adiciona as seguintes interfaces fornecidas pela estrutura:

A versão 1.11 adiciona os seguintes recursos aos drivers baseados em UMDF:

Acessando hardware e manipulando interrupções
Usando o pool de dispositivos em drivers UMDF
Adicionadas as diretivas UmdfHostProcessSharing, UmdfDirectHardwareAccess, UmdfRegisterAccessMode, UmdfFileObjectPolicy e UmdfFsContextUsePolicy , descritas em Especificando diretivas WDF em arquivos INF
Identificadores de segurança conhecidos (SID) para drivers UMDF
Suporte ao repositório unificado de propriedades, descrito em Usando o Registro em drivers baseados em UMDF
IoGetDeviceObjectPointer é integrado para trabalhar com UMDF. Em versões anteriores, essa rotina fecha o identificador para o objeto de dispositivo depois de fazer uma referência no identificador do dispositivo. Esse comportamento era incompatível com a expectativa do UMDF de que a solicitação de limpeza no objeto de dispositivo não ocorrerá até que toda a E/S seja concluída.
Criando minidrivers HID baseados em UMDF
Suporte aprimorado para suporte a desligamento ocioso em drivers baseados em UMDF. A estrutura agora pode colocar o dispositivo no estado de energia D3cold quando o período de tempo limite ocioso expirar. A estrutura também pode fazer com que o dispositivo retorne ao seu estado de trabalho (D0) quando o sistema retornar ao seu estado de trabalho (S0).
Os seguintes exemplos são novos no UMDF 1.11: WudfVhidmini, NetNfpProvider.

UMDF 1.9 (Windows 7)

A versão 1.9 adiciona as seguintes interfaces de retorno de chamada fornecidas pelo driver:

A versão 1.9 adiciona as seguintes interfaces fornecidas pela estrutura:

Essas interfaces adicionam os seguintes recursos aos drivers baseados em UMDF:

Destinos de E/S remota
Propriedade da política de energia
O método de acesso direto ao buffer de E/S
Leitores contínuos para dispositivos USB
Suporte aprimorado para interfaces de dispositivo
Capacidade aprimorada de cancelar solicitações de E/S
Acesso aprimorado ao registro

Compartilhar via