История версий DirectML

DirectML распространяется как системный компонент Windows и доступен в составе операционной системы Windows в Windows 10 версии 1903 (10.0; Сборка 18362) и более поздних версий.

Начиная с Версии 1.4.0 DirectML, DirectML также доступен как автономный распространяемый пакет (см. Microsoft.AI.DirectML), который полезен для приложений, которые хотят использовать фиксированную версию DirectML, или при запуске в более ранних версиях Windows 10.

DirectML следует принципам семантического версионирования. То есть номера версий соответствуют форме major.minor.patch. Первый выпуск DirectML имеет версию 1.0.0.

Таблица версий

¹ Промежуточные выпуски DirectML 1.2.0 и 1.3.0 были недоступны.

Выбор целевой версии DirectML

Для удобства некоторые особенности в файле заголовка DirectML.h объявляются условно, в зависимости от значения макроса DML_TARGET_VERSION. Задав DML_TARGET_VERSION макрос определенным значениям, можно исключить части DirectML.h из приложения.

Это может быть полезно, если вы используете более новую копию DirectML.h, но вы нацелены на более низкую версию двоичного файла DirectML, так как это гарантирует, что любая попытка использовать функции за пределами выбранного целевого уровня не будет компилироваться. Этот механизм похож на NTDDI_VERSION макрос (см. макросы для условных объявлений).

Ниже приведены допустимые значения макроса DML_TARGET_VERSION .

Если DML_TARGET_VERSION параметр не задан, он выбирается автоматически следующим образом.

• DML_TARGET_VERSION_USE_LATEST Если макрос определен, выбрана последняя целевая версия.
• В противном случае целевая версия выбирается на основе значения NTDDI_VERSION макроса.
  • NTDDI_WIN10_ZN приводит к целевой версии 0x6000.
  • NTDDI_WIN10_NI приводит к целевой версии 0x5000.
  • NTDDI_WIN10_CO приводит к целевой версии 0x4000.
  • NTDDI_WIN10_FE приводит к целевой версии 0x3000.
  • NTDDI_WIN10_VB приводит к целевой версии 0x2000.
  • NTDDI_WIN10_19H1 приводит к целевой версии 0x1000.
  • Если NTDDI_VERSION не определено, выбрана последняя целевая версия (как если бы было указано DML_TARGET_VERSION_USE_LATEST).

Пример

Рассмотрим приложение с помощью версии 10.0.19041.0 (Windows 10 версии 2004) пакета SDK для Windows. В приведенной выше таблице версия DirectML 1.1.0 соответствует DML_TARGET_VERSION, и соответствующий 0x2000.

Если вы не задаете ни макросы DML_TARGET_VERSION, ни NTDDI_VERSION, то выбранная целевая версия по умолчанию установится на 0x2000, и все в DirectML.h будет доступно для использования.

Если вы хотите, чтобы ваше приложение могло работать на Windows 10 версии 1903 (10.0; Сборка 18362), то вы можете #define DML_TARGET_VERSION 0x1000, чтобы исключить весь контент в DirectML.h, который не поддерживается DirectML версии 1.0.0. Это гарантирует, что любая попытка использовать функциональные возможности, требующие большей версии, не будет компилироваться.

Версия DirectML и уровень компонентов

Версия DirectML (например, 1.0.0 или 1.4.0) описывает конкретный выпуск DirectML, включая связанные с ним файл заголовков DirectML.h и файл .lib.

Уровень компонентов (например, DML_FEATURE_LEVEL_1_0или DML_FEATURE_LEVEL_2_0) описывает возможности базовой реализации API, которая может отличаться от используемой DirectML.h версии.

Например, сборка приложения с более новым пакетом SDK, но работающая в более старой версии Windows, может (во время выполнения) увидеть более низкий поддерживаемый уровень компонентов, даже если он компилируется по последнему пакету SDK.

См. также

• Windows AI
• История уровней функций DirectML
• Перечисление DML_FEATURE_LEVEL
• Распространяемый пакет Microsoft.AI.DirectML