Histórico de versões do UMDF

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.

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)

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

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:

• WdfDeviceConfigureWdmIrpDispatchCallback
• EvtDeviceWdmIrpDispatch
• WdfDeviceWdmDispatchIrp
• WdfDeviceWdmDispatchIrpToIoQueue

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:

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

• 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:

• IPnpCallbackHardware2

• IPnpCallbackHardwareInterrupt

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

• IWDFCmResourceList

• IWDFDevice3

• IWDFFile3

• IWDFInterrupt

• IWDFIoRequest3

• IWDFUnifiedPropertyStore

• IWDFUnifiedPropertyStoreFactory

• IWDFWorkItem

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:

• IPnpCallbackRemoteInterfaceNotification

• IPowerPolicyCallbackWakeFromS0

• IPowerPolicyCallbackWakeFromSx

• IQueueCallbackIoCanceledOnQueue

• IRemoteInterfaceCallbackEvent

• IRemoteInterfaceCallbackRemoval

• IRemoteTargetCallbackRemoval

• IWDFRemoteInterfaceInitialize

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

• IWDFDevice2

• IWDFDeviceInitialize2

• IWDFFile2

• IWDFIoRequest2

• IWDFIoTarget2

• IWDFNamedPropertyStore2

• IWDFPropertyStoreFactory

• IWDFRemoteTarget

• IWDFUsbTargetPipe2

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