DMLCreateDevice 函式 (directml.h)

  • 發行項

為指定的 Direct3D 12 裝置建立 DirectML 裝置。

語法

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

參數

d3d12Device

類型： ID3D12Device*

ID3D12Device的指標，代表用來建立 DirectML 裝置的 Direct3D 12 裝置。 DirectML 支援任何 D3D 功能層級，以及在任何配接器上建立的 Direct3D 12 裝置，包括 WARP。 不過，根據 Direct3D 12 裝置的功能而定，DirectML 中的所有功能都無法使用。 如需詳細資訊 ，請參閱 IDMLDevice：：CheckFeatureSupport 。

如果呼叫 DMLCreateDevice 成功，則 DirectML 裝置會維護所提供 Direct3D 12 裝置的強式參考。

flags

類型： DML_CREATE_DEVICE_FLAGS

指定其他裝置建立選項 的DML_CREATE_DEVICE_FLAGS 值。

riid

類型： REFIID

您想要在 裝置中傳回之介面的全域唯一識別碼 (GUI) D 參考。 這必須是 IDMLDevice 的 GUID。

ppv

類型：_COM_Outptr_opt_ void**

接收裝置指標的記憶體區塊指標。 這是 IDMLDevice指標的位址，代表所建立的 DirectML 裝置。

傳回值

類型： HRESULT

如果函式成功，它會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

DirectML 1.1.0 版引進了較新版本的此函式 DMLCreateDevice1。 DMLCreateDevice相當於呼叫DMLCreateDevice1，並提供DML_FEATURE_LEVEL_1_0的 minimumFeatureLevel。

需求

   
最低支援的用戶端 Windows 10 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2016 [僅限傳統型應用程式]
目標平台 Windows
標頭 directml.h
程式庫 DirectML.lib
Dll DirectML.dll

另請參閱