DirectML-versiegeschiedenis

DirectML wordt gedistribueerd als systeemonderdeel van Windows en is beschikbaar als onderdeel van het Windows-besturingssysteem (OS) in Windows 10, versie 1903 (10.0; Build 18362) en hoger.

Vanaf DirectML versie 1.4.0 is DirectML ook beschikbaar als een zelfstandig herdistribueerbaar pakket (zie Microsoft.AI.DirectML), wat handig is voor toepassingen die een vaste versie van DirectML willen gebruiken of wanneer ze worden uitgevoerd in oudere versies van Windows 10.

DirectML volgt de semantische versiebeheerconventies. Dat wil zeggen, versienummers volgen het formaat major.minor.patch. De eerste release van DirectML heeft een versie van 1.0.0.

Versietabel

¹ De tussenliggende releases 1.2.0 en 1.3.0 van DirectML werden niet algemeen beschikbaar gesteld.

Een DirectML-doelversie selecteren

Voor het gemak worden bepaalde functies in het DirectML.h koptekstbestand voorwaardelijk gedeclareerd op basis van de waarde van de DML_TARGET_VERSION macro. Door de DML_TARGET_VERSION macro in te stellen op bepaalde waarden, kunt u delen van DirectML.h van uw toepassing uitsluiten.

Als u een nieuwere kopie van DirectML.h gebruikt, maar zich richt op een lagere versie van de DirectML-binaire, kan dat handig zijn, omdat het ervoor zorgt dat elke poging om functies buiten het gekozen doelniveau te gebruiken niet gecompileerd kunnen worden. Dit mechanisme is vergelijkbaar met de NTDDI_VERSION macro (zie Macro's voor voorwaardelijke declaraties).

Dit zijn de geldige waarden voor de DML_TARGET_VERSION macro.

Als DML_TARGET_VERSION niet is ingesteld, wordt het automatisch geselecteerd volgens de volgende procedure.

• Als de DML_TARGET_VERSION_USE_LATEST macro is gedefinieerd, wordt de meest recente doelversie geselecteerd.
• Anders wordt de doelversie geselecteerd op basis van de waarde van de NTDDI_VERSION macro.
  • NTDDI_WIN10_ZN resulteert in een doelversie van 0x6000.
  • NTDDI_WIN10_NI resulteert in een doelversie van 0x5000.
  • NTDDI_WIN10_CO resulteert in een doelversie van 0x4000.
  • NTDDI_WIN10_FE resulteert in een doelversie van 0x3000.
  • NTDDI_WIN10_VB resulteert in een doelversie van 0x2000.
  • NTDDI_WIN10_19H1 resulteert in een doelversie van 0x1000.
  • Als NTDDI_VERSION niet is gedefinieerd, wordt de meest recente doelversie geselecteerd (alsof DML_TARGET_VERSION_USE_LATEST was opgegeven).

Voorbeeld

Overweeg een toepassing met versie 10.0.19041.0 (Windows 10, versie 2004) van de Windows Software Development Kit (SDK). In de bovenstaande tabel is de versie van DirectML waarmee dit overeenkomt 1.1.0 en de bijbehorende DML_TARGET_VERSION is 0x2000.

Als u noch de DML_TARGET_VERSION noch de NTDDI_VERSION macro's instelt, wordt de geselecteerde doelversie standaard 0x2000, en is alles in DirectML.h beschikbaar voor gebruik.

Als u wilt dat uw toepassing kan worden uitgevoerd op Windows 10, versie 1903 (10.0; Build 18362), dan kunt u #define DML_TARGET_VERSION 0x1000, waardoor alle inhoud in DirectML.h wordt uitgesloten die niet wordt ondersteund door DirectML versie 1.0.0. Dit zorgt ervoor dat elke poging om functionaliteit te gebruiken waarvoor een grotere versie vereist, niet kan worden gecompileerd.

DirectML-versie versus functieniveau

De DirectML-versie (bijvoorbeeld 1.0.0 of 1.4.0) beschrijft een bepaalde versie van DirectML, inclusief het bijbehorende DirectML.h headerbestand en .lib -bestand.

Het functieniveau (bijvoorbeeld DML_FEATURE_LEVEL_1_0, of DML_FEATURE_LEVEL_2_0) beschrijft de mogelijkheid van de onderliggende implementatie van de API, die kan variëren van de gebruikte versie DirectML.h .

Een toepassing die bouwt op basis van een nieuwere SDK, maar wordt uitgevoerd op een oudere versie van Windows, kan (tijdens runtime) een lager ondersteund functieniveau zien, zelfs als deze is gecompileerd op basis van de nieuwste SDK.

Zie ook

• Windows AI
• Geschiedenis van DirectML-functieniveau
• enumeratie DML_FEATURE_LEVEL
• Herdistribueerbaar microsoft.AI.DirectML-pakket