Historique des versions DirectML

DirectML est distribué en tant que composant système de Windows et est disponible dans le cadre du système d’exploitation Windows dans Windows 10, version 1903 (10.0 ; Build 18362) et versions ultérieures.

À compter de DirectML version 1.4.0, DirectML est également disponible en tant que package redistribuable autonome (voir Microsoft.AI.DirectML), qui est utile pour les applications qui souhaitent utiliser une version fixe de DirectML ou lors de l’exécution sur des versions antérieures de Windows 10.

DirectML suit les conventions de gestion sémantique de version. Autrement dit, les numéros de version suivent le formulaire major.minor.patch. La première version de DirectML a une version 1.0.0.

Table de version

¹ Les versions intermédiaires 1.2.0 et 1.3.0 de DirectML n’ont pas été rendues largement disponibles.

Sélection d’une version cible DirectML

Par souci de commodité, certaines fonctionnalités du fichier d’en-tête DirectML.h sont déclarées de manière conditionnelle en fonction de la valeur de la macro DML_TARGET_VERSION. En définissant la macro DML_TARGET_VERSION sur certaines valeurs, vous pouvez exclure des parties de DirectML.h de votre application.

Cela peut être utile si vous utilisez une copie plus récente de DirectML.h, mais vous ciblez une version inférieure du fichier binaire DirectML, car cela garantit que toute tentative d'utiliser des fonctionnalités au-delà du niveau cible choisi ne compilera pas. Ce mécanisme est similaire à la macro NTDDI_VERSION (voir Macros pour les déclarations conditionnelles).

Voici les valeurs valides pour la macro DML_TARGET_VERSION.

Si DML_TARGET_VERSION n’est pas défini, il est sélectionné automatiquement par les éléments suivants.

• Si la macro DML_TARGET_VERSION_USE_LATEST est définie, la dernière version cible est sélectionnée.
• Sinon, la version cible est sélectionnée en fonction de la valeur de la macro NTDDI_VERSION.
  • NTDDI_WIN10_ZN génère une version cible de 0x6000.
  • NTDDI_WIN10_NI génère une version cible de 0x5000.
  • NTDDI_WIN10_CO génère une version cible de 0x4000.
  • NTDDI_WIN10_FE génère une version cible de 0x3000.
  • NTDDI_WIN10_VB génère une version cible de 0x2000.
  • NTDDI_WIN10_19H1 génère une version cible de 0x1000.
  • Si NTDDI_VERSION n’est pas définie, la dernière version cible est sélectionnée (comme si DML_TARGET_VERSION_USE_LATEST était spécifiée).

Exemple

Considérez une application qui utilise la version 10.0.19041.0 (Windows 10, version 2004) du Kit de développement logiciel Windows (Kit SDK Windows). Dans le tableau ci-dessus, la version de DirectML est la version correspondant à la 1.1.0 et la valeur correspondante DML_TARGET_VERSION est 0x2000.

Si vous ne définissez ni DML_TARGET_VERSION ni les macros NTDDI_VERSION, la version cible sélectionnée sera 0x2000 par défaut, et tout ce qui se trouve dans DirectML.h sera disponible à l’utilisation.

Si vous souhaitez que votre application puisse s’exécuter sur Windows 10, version 1903 (10.0 ; Build 18362), vous pouvez #define DML_TARGET_VERSION 0x1000, ce qui exclue tout le contenu dans DirectML.h qui n’est pas pris en charge par DirectML version 1.0.0. Cela garantit que toute tentative d’utilisation des fonctionnalités nécessitant une version plus élevée échoue à compiler.

Version DirectML et niveau de fonctionnalité

La version DirectML (par exemple, 1.0.0 ou 1.4.0) décrit une version particulière de DirectML, y compris ses fichiers d’en-tête DirectML.h et ses fichiers .lib associés.

Le niveau de fonctionnalité (par exemple, DML_FEATURE_LEVEL_1_0 ou DML_FEATURE_LEVEL_2_0) décrit la capacité de l’implémentation sous-jacente de l’API, qui peut varier selon version utilisée de DirectML.h.

Par exemple, une application qui s’appuie sur un kit SDK plus récent, mais qui s’exécute sur une version antérieure de Windows, peut (lors du runtime) voir un niveau de fonctionnalité inférieur, même s’il est compilé sur le dernier kit de développement logiciel (SDK).

Voir aussi

• Windows IA
• Historique des niveaux de fonctionnalité DirectML
• Énumération DML_FEATURE_LEVEL
• Package redistribuable Microsoft.AI.DirectML