Share via

DMLCreateDevice 関数 (directml.h)

  • [アーティクル]

特定のDirect3D 12 デバイスの DirectML デバイスを作成します。

構文

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

パラメーター

d3d12Device

種類: ID3D12Device*

DirectML デバイスを作成するDirect3D 12デバイスを表す ID3D12Device へのポインター。 DirectML では、任意の D3D 機能レベルと、WARP を含む任意のアダプターで作成されたDirect3D 12デバイスがサポートされます。 ただし、Direct3D 12 デバイスの機能によっては、DirectML のすべての機能を使用できるわけではありません。 詳細については、「 IDMLDevice::CheckFeatureSupport 」を参照してください。

DMLCreateDevice の呼び出しが成功した場合、DirectML デバイスは、指定されたDirect3D 12 デバイスへの厳密な参照を保持します。

flags

種類: DML_CREATE_DEVICE_FLAGS

追加のデバイス作成オプションを指定する DML_CREATE_DEVICE_FLAGS 値。

riid

種類: REFIID

デバイスで返されるインターフェイスのグローバル一意識別子 (GUID) への参照。 これは IDMLDevice の GUID である必要があります。

ppv

型: void _COM_Outptr_opt_**

デバイスへのポインターを受け取るメモリ ブロックへのポインター。 これは、作成された DirectML デバイスを表す IDMLDevice へのポインターのアドレスです。

戻り値

種類: HRESULT

関数が成功した場合は、S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

解説

この関数の新しいバージョン である DMLCreateDevice1 は、DirectML バージョン 1.1.0 で導入されました。 DMLCreateDevice は、DMLCreateDevice1 を呼び出し、DML_FEATURE_LEVEL_1_0の minimumFeatureLevel を指定することと同じです。

要件

   
サポートされている最小のクライアント Windows 10 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2016 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー directml.h
Library DirectML.lib
[DLL] DirectML.dll

関連項目