Histórico de versões do DirectML

O DirectML é distribuído como um componente do sistema do Windows e está disponível como parte do sistema operacional Windows no Windows 10, versão 1903 (10.0; Build 18362) e mais recente.

A partir da versão 1.4.0 do DirectML, o DirectML também está disponível como um pacote redistribuível autônomo (consulte Microsoft.AI.DirectML), que é útil para aplicativos que desejam usar uma versão fixa do DirectML ou quando executados em versões mais antigas do Windows 10.

O DirectML segue as convenções de versionamento semântico . Ou seja, os números de versão seguem o formulário major.minor.patch. A primeira versão do DirectML tem uma versão de 1.0.0.

Tabela de versões

¹ As versões intermediárias 1.2.0 e 1.3.0 do DirectML não foram amplamente disponibilizadas.

Selecionando uma versão de destino do DirectML

Por conveniência, determinados recursos no DirectML.h arquivo de cabeçalho são declarados condicionalmente com base no valor da DML_TARGET_VERSION macro. Ao definir a DML_TARGET_VERSION macro para determinados valores, pode excluir partes do DirectML.h do seu aplicativo.

Isso pode ser útil se estiver a usar uma versão mais recente de DirectML.h, mas tenha como objetivo uma versão inferior do binário DirectML, pois garante que qualquer tentativa de usar recursos além do nível de destino escolhido não conseguirá ser compilada. Este mecanismo é semelhante à NTDDI_VERSION macro (consulte Macros para declarações condicionais).

Aqui estão os valores válidos para a DML_TARGET_VERSION macro.

Se DML_TARGET_VERSION não estiver definido, então ele é selecionado automaticamente pelo seguinte.

• Se a DML_TARGET_VERSION_USE_LATEST macro estiver definida, a versão de destino mais recente será selecionada.
• Caso contrário, a versão de destino é selecionada com base no valor da NTDDI_VERSION macro.
  • NTDDI_WIN10_ZN resulta em uma versão de destino do 0x6000.
  • NTDDI_WIN10_NI resulta em uma versão de destino do 0x5000.
  • NTDDI_WIN10_CO resulta em uma versão de destino do 0x4000.
  • NTDDI_WIN10_FE resulta em uma versão de destino do 0x3000.
  • NTDDI_WIN10_VB resulta em uma versão de destino do 0x2000.
  • NTDDI_WIN10_19H1 resulta em uma versão de destino do 0x1000.
  • Se NTDDI_VERSION não estiver definido, a versão de destino mais recente será selecionada (como se DML_TARGET_VERSION_USE_LATEST tivesse sido especificada).

Exemplo

Considere um aplicativo usando a versão 10.0.19041.0 (Windows 10, versão 2004) do Windows Software Development Kit (SDK). Na tabela acima, a versão do DirectML à qual isso corresponde é 1.1.0 e a correspondente DML_TARGET_VERSION é 0x2000.

Se não definir as macros DML_TARGET_VERSION nem NTDDI_VERSION, a versão de destino selecionada será por padrão 0x2000, e tudo em DirectML.h estará disponível para uso.

Se você quiser que seu aplicativo possa ser executado no Windows 10, versão 1903 (10.0; Build 18362), então você pode #define DML_TARGET_VERSION 0x1000, o que excluirá todo o conteúdo DirectML.h que não é suportado pelo DirectML versão 1.0.0. Isso garante que qualquer tentativa de usar a funcionalidade que exija uma versão maior não será compilada.

Versão do DirectML versus nível de funcionalidade

A versão do DirectML (por exemplo, 1.0.0 ou 1.4.0) descreve um lançamento específico do DirectML, incluindo o seu arquivo de cabeçalho DirectML.h e o arquivo associado .lib.

O nível de funcionalidade (por exemplo, DML_FEATURE_LEVEL_1_0, ou DML_FEATURE_LEVEL_2_0) descreve a capacidade da implementação subjacente da API, que pode variar consoante a versão de DirectML.h utilizada.

Por exemplo, o desenvolvimento de uma aplicação contra um SDK mais recente, mas em execução numa versão mais antiga do Windows, pode, em tempo de execução, observar um nível de funcionalidades suportadas mais baixo, mesmo que tenha sido compilada com o SDK mais recente.

Ver também

• de IA do Windows
• Histórico de nível de funcionalidade do DirectML
• Enumeração de Características do DML
• Pacote redistribuível Microsoft.AI.DirectML