Fonction DMLCreateDevice (directml.h)

  • Article

Crée un appareil DirectML pour un appareil Direct3D 12 donné.

Syntaxe

HRESULT DMLCreateDevice(
  ID3D12Device            *d3d12Device,
  DML_CREATE_DEVICE_FLAGS flags,
  REFIID                  riid,
  void                    **ppv
);

Paramètres

d3d12Device

Type : ID3D12Device*

Pointeur vers un id3D12Device représentant l’appareil Direct3D 12 sur lequel créer l’appareil DirectML. DirectML prend en charge n’importe quel niveau de fonctionnalité D3D et les appareils Direct3D 12 créés sur n’importe quel adaptateur, y compris WARP. Toutefois, toutes les fonctionnalités de DirectML peuvent ne pas être disponibles en fonction des fonctionnalités de l’appareil Direct3D 12. Pour plus d’informations, consultez IDMLDevice::CheckFeatureSupport .

Si l’appel à DMLCreateDevice réussit, l’appareil DirectML conserve une référence forte à l’appareil Direct3D 12 fourni.

flags

Type : DML_CREATE_DEVICE_FLAGS

Valeur DML_CREATE_DEVICE_FLAGS spécifiant des options de création d’appareils supplémentaires.

riid

Type : REFIID

Référence à l’identificateur global unique (GUID) de l’interface que vous souhaitez retourner dans l’appareil. Il s’agit normalement du GUID d’IDMLDevice.

ppv

Type : _COM_Outptr_opt_ void**

Pointeur vers un bloc de mémoire qui reçoit un pointeur vers l’appareil. Il s’agit de l’adresse d’un pointeur vers un IDMLDevice, représentant l’appareil DirectML créé.

Valeur retournée

Type : HRESULT

Si la fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Notes

Une version plus récente de cette fonction, DMLCreateDevice1, a été introduite dans DirectML version 1.1.0. DMLCreateDevice équivaut à appeler DMLCreateDevice1 et à fournir un minimumFeatureLevel de DML_FEATURE_LEVEL_1_0.

Spécifications

   
Client minimal pris en charge Windows 10 (applications de bureau uniquement)
Serveur minimal pris en charge Windows Server 2016 (applications de bureau uniquement)
Plateforme cible Windows
En-tête directml.h
Bibliothèque DirectML.lib
DLL DirectML.dll

Voir aussi