DMLCreateDevice-Funktion (directml.h)

  • Artikel

Erstellt ein DirectML-Gerät für ein bestimmtes Direct3D 12-Gerät.

Syntax

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

Parameter

d3d12Device

Typ: ID3D12Geräte*

Ein Zeiger auf ein ID3D12Device, das das Direct3D 12-Gerät darstellt, über das das DirectML-Gerät erstellt werden soll. DirectML unterstützt alle D3D-Featureebenen und Direct3D 12-Geräte, die auf einem beliebigen Adapter erstellt werden, einschließlich WARP. Abhängig von den Funktionen des Direct3D 12-Geräts sind jedoch möglicherweise nicht alle Features in DirectML verfügbar. Weitere Informationen finden Sie unter IDMLDevice::CheckFeatureSupport .

Wenn der Aufruf von DMLCreateDevice erfolgreich ist, verwaltet das DirectML-Gerät einen starken Verweis auf das bereitgestellte Direct3D 12-Gerät.

flags

Typ: DML_CREATE_DEVICE_FLAGS

Ein DML_CREATE_DEVICE_FLAGS Wert, der zusätzliche Optionen für die Geräteerstellung angibt.

riid

Typ: REFIID

Ein Verweis auf die GUID (Globally Unique Identifier) der Schnittstelle, die auf dem Gerät zurückgegeben werden soll. Es wird erwartet, dass dies die GUID von IDMLDevice ist.

ppv

Typ: _COM_Outptr_opt_ void**

Ein Zeiger auf einen Speicherblock, der einen Zeiger auf das Gerät empfängt. Dies ist die Adresse eines Zeigers auf ein IDMLDevice, das das erstellte DirectML-Gerät darstellt.

Rückgabewert

Typ: HRESULT

Wenn die Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Eine neuere Version dieser Funktion, DMLCreateDevice1, wurde in DirectML Version 1.1.0 eingeführt. DMLCreateDevice entspricht dem Aufrufen von DMLCreateDevice1 und dem Bereitstellen eines MinimumFeatureLevels von DML_FEATURE_LEVEL_1_0.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 10 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2016 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile directml.h
Bibliothek DirectML.lib
DLL DirectML.dll

Weitere Informationen