Histórico de versões do DirectML

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

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

O DirectML segue as convenções do controle de versão semântica. Ou seja, os números de versão seguem a forma major.minor.patch. A primeira versão do DirectML tem uma versão 1.0.0.

Tabela de versões

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

Selecionar uma versão de destino do DirectML

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

Isso pode ser útil se você estiver usando uma cópia mais recente do DirectML.h, mas estiver direcionando para 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 será compilada. Esse mecanismo é semelhante à macro (consulte NTDDI_VERSION Macros para declarações condicionais).

Estes são os valores válidos para a macro DML_TARGET_VERSION.

Se DML_TARGET_VERSION não estiver definido, ele será selecionado automaticamente pelo seguinte.

• Se a macro DML_TARGET_VERSION_USE_LATEST estiver definida, a versão de destino mais recente será selecionada.
• Caso contrário, a versão de destino será selecionada com base no valor da macro NTDDI_VERSION.
  • 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 fosse 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 DML_TARGET_VERSION correspondente é 0x2000.

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

Se você quiser que seu aplicativo seja executado no Windows 10, versão 1903 (10.0; Build 18362), use o #define DML_TARGET_VERSION 0x1000, que excluirá todo o conteúdo de DirectML.h que não for compatível com o DirectML versão 1.0.0. Isso garante que qualquer tentativa de usar a funcionalidade que exija uma versão maior falhará na compilação.

Versão do DirectML versus nível de recurso

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

O nível de recurso (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 da versão DirectML.h usada.

Por exemplo, um aplicativo criado em um SDK mais recente, porém executado em uma versão mais antiga do Windows, pode (no runtime) observar um nível de recurso com suporte mais baixo, mesmo que ele seja compilado com o SDK mais recente.

Confira também

• IA do Windows
• Histórico do nível de recurso do DirectML
• Enumeração DML_FEATURE_LEVEL
• Pacote redistribuível Microsoft.AI.DirectML