ホーム › Graphics.Direct3D11on12 › D3D11On12CreateDevice

D3D11On12CreateDevice

関数

既存のDirect3D12デバイス上にDirect3D11デバイスを作成する。

DLLd3d11.dll呼出規約winapi

シグネチャ

// d3d11.dll
#include <windows.h>

HRESULT D3D11On12CreateDevice(
    IUnknown* pDevice,
    DWORD Flags,
    const D3D_FEATURE_LEVEL* pFeatureLevels,   // optional
    DWORD FeatureLevels,
    IUnknown** ppCommandQueues,   // optional
    DWORD NumQueues,
    DWORD NodeMask,
    ID3D11Device** ppDevice,   // optional
    ID3D11DeviceContext** ppImmediateContext,   // optional
    D3D_FEATURE_LEVEL* pChosenFeatureLevel   // optional
);

パラメーター

名前	型	方向	説明
pDevice	IUnknown*	in	Direct3D 11 との相互運用に使用する、既存の Direct3D 12 デバイスを指定します。NULL にすることはできません。
Flags	DWORD	in	D3D11_CREATE_DEVICE_FLAG のフラグを 1 つ以上ビットごとの OR で組み合わせた値です。これらは D3D11CreateDeviceAndSwapChain で使用されるフラグと同じです。有効にするランタイムのレイヤーを指定します。Flags はデバイスのフラグと互換性がある必要があり、その NodeMask は present API に渡される NodeMask のサブセットである必要があります。
pFeatureLevels	D3D_FEATURE_LEVEL*	inoptional	次のいずれかの値の配列です。 D3D_FEATURE_LEVEL_12_1 D3D_FEATURE_LEVEL_12_0 D3D_FEATURE_LEVEL_11_1 D3D_FEATURE_LEVEL_11_0 D3D_FEATURE_LEVEL_10_1 D3D_FEATURE_LEVEL_10_0 D3D_FEATURE_LEVEL_9_3 D3D_FEATURE_LEVEL_9_2 D3D_FEATURE_LEVEL_9_1 Direct3D 12 デバイスの機能レベル以下である最初の機能レベルが、Direct3D 11 の検証を行うために使用されます。使用可能な機能レベルが 1 つも指定されていない場合、作成は失敗します。NULL を指定した場合は、既定で Direct3D 12 デバイスの機能レベルが使用されます。
FeatureLevels	DWORD	in	pFeatureLevels 配列のサイズ (つまり要素数) です。
ppCommandQueues	IUnknown**	inoptional	D3D11On12 が使用する、一意のキューの配列です。キューは 3D コマンドキューの種類である必要があります。
NumQueues	DWORD	in	ppCommandQueues 配列のサイズ (つまり要素数) です。
NodeMask	DWORD	in	使用する Direct3D 12 デバイスのノードを指定します。設定できるビットは 1 つだけです。
ppDevice	ID3D11Device**	outoptional	返される ID3D11Device へのポインターです。NULL でもかまいません。
ppImmediateContext	ID3D11DeviceContext**	outoptional	返される ID3D11DeviceContext へのポインターです。NULL でもかまいません。
pChosenFeatureLevel	D3D_FEATURE_LEVEL*	outoptional	返される機能レベルへのポインターです。NULL でもかまいません。

戻り値の型: HRESULT

公式ドキュメント

Direct3D 12 上で Direct3D 11 の機能を使用するデバイスを作成します。Direct3D 11 との相互運用に使用する既存の Direct3D 12 デバイスを指定します。

戻り値

型: HRESULT

このメソッドは、D3D11CreateDevice について記載されている Direct3D 12 の戻り値コードのいずれかを返します。

Flags に D3D11_CREATE_DEVICE_DEBUG を指定し、かつコンピューターにインストールされているデバッグレイヤーのバージョンが正しくない場合、このメソッドは DXGI_ERROR_SDK_COMPONENT_MISSING を返します。正しいバージョンを入手するには、最新の Windows SDK をインストールしてください。

解説(Remarks)

関数シグネチャ PFN_D3D11ON12_CREATE_DEVICE が typedef として提供されているため、静的リンクの代わりに動的リンクの手法 (GetProcAddress) を使用できます。

使用例

11On12 デバイスを介して Direct2D を使用し、Direct3D 12 の上にテキストを描画するには、レンダリングパイプラインの依存関係を読み込みます。

// Load the rendering pipeline dependencies.
void D3D1211on12::LoadPipeline()
{
    UINT d3d11DeviceFlags = D3D11_CREATE_DEVICE_BGRA_SUPPORT;
    D2D1_FACTORY_OPTIONS d2dFactoryOptions = {};
#if defined(_DEBUG)
    // Enable the D2D debug layer.
    d2dFactoryOptions.debugLevel = D2D1_DEBUG_LEVEL_INFORMATION;

    // Enable the Direct3D 11 debug layer.
    d3d11DeviceFlags |= D3D11_CREATE_DEVICE_DEBUG;
    
    // Enable the Direct3D 12 debug layer.
    {
        ComPtr<ID3D12Debug> debugController;
        if (SUCCEEDED(D3D12GetDebugInterface(IID_PPV_ARGS(&debugController))))
        {
            debugController->EnableDebugLayer();
        }
    }
#endif

    ComPtr<IDXGIFactory4> factory;
    ThrowIfFailed(CreateDXGIFactory1(IID_PPV_ARGS(&factory)));

    if (m_useWarpDevice)
    {
        ComPtr<IDXGIAdapter> warpAdapter;
        ThrowIfFailed(factory->EnumWarpAdapter(IID_PPV_ARGS(&warpAdapter)));

        ThrowIfFailed(D3D12CreateDevice(
            warpAdapter.Get(),
            D3D_FEATURE_LEVEL_11_0,
            IID_PPV_ARGS(&m_d3d12Device)
            ));
    }
    else
    {
        ComPtr<IDXGIAdapter1> hardwareAdapter;
        GetHardwareAdapter(factory.Get(), &hardwareAdapter);

        ThrowIfFailed(D3D12CreateDevice(
            hardwareAdapter.Get(),
            D3D_FEATURE_LEVEL_11_0,
            IID_PPV_ARGS(&m_d3d12Device)
            ));
    }

    // Describe and create the command queue.
    D3D12_COMMAND_QUEUE_DESC queueDesc = {};
    queueDesc.Flags = D3D12_COMMAND_QUEUE_FLAG_NONE;
    queueDesc.Type = D3D12_COMMAND_LIST_TYPE_DIRECT;

    ThrowIfFailed(m_d3d12Device->CreateCommandQueue(&queueDesc, IID_PPV_ARGS(&m_commandQueue)));

    // Describe the swap chain.
    DXGI_SWAP_CHAIN_DESC swapChainDesc = {};
    swapChainDesc.BufferCount = FrameCount;
    swapChainDesc.BufferDesc.Width = m_width;
    swapChainDesc.BufferDesc.Height = m_height;
    swapChainDesc.BufferDesc.Format = DXGI_FORMAT_R8G8B8A8_UNORM;
    swapChainDesc.BufferUsage = DXGI_USAGE_RENDER_TARGET_OUTPUT;
    swapChainDesc.SwapEffect = DXGI_SWAP_EFFECT_FLIP_DISCARD;
    swapChainDesc.OutputWindow = Win32Application::GetHwnd();
    swapChainDesc.SampleDesc.Count = 1;
    swapChainDesc.Windowed = TRUE;

    ComPtr<IDXGISwapChain> swapChain;
    ThrowIfFailed(factory->CreateSwapChain(
        m_commandQueue.Get(),        // Swap chain needs the queue so that it can force a flush on it.
        &swapChainDesc,
        &swapChain
        ));

    ThrowIfFailed(swapChain.As(&m_swapChain));

    // This sample does not support fullscreen transitions.
    ThrowIfFailed(factory->MakeWindowAssociation(Win32Application::GetHwnd(), DXGI_MWA_NO_ALT_ENTER));

    m_frameIndex = m_swapChain->GetCurrentBackBufferIndex();

    // Create an 11 device wrapped around the 12 device and share
    // 12's command queue.
    ComPtr<ID3D11Device> d3d11Device;
    ThrowIfFailed(D3D11On12CreateDevice(
        m_d3d12Device.Get(),
        d3d11DeviceFlags,
        nullptr,
        0,
        reinterpret_cast<IUnknown**>(m_commandQueue.GetAddressOf()),
        1,
        0,
        &d3d11Device,
        &m_d3d11DeviceContext,
        nullptr
        ));

    // Query the 11On12 device from the 11 device.
    ThrowIfFailed(d3d11Device.As(&m_d3d11On12Device));

    // Create D2D/DWrite components.
    {
        D2D1_DEVICE_CONTEXT_OPTIONS deviceOptions = D2D1_DEVICE_CONTEXT_OPTIONS_NONE;
        ThrowIfFailed(D2D1CreateFactory(
            D2D1_FACTORY_TYPE_SINGLE_THREADED,
            __uuidof(ID2D1Factory3),
            &d2dFactoryOptions,
            &m_d2dFactory));
        ComPtr<IDXGIDevice> dxgiDevice;
        ThrowIfFailed(m_d3d11On12Device.As(&dxgiDevice));
        ThrowIfFailed(m_d2dFactory->CreateDevice(dxgiDevice.Get(), &m_d2dDevice));
        ThrowIfFailed(m_d2dDevice->CreateDeviceContext(deviceOptions, &m_d2dDeviceContext));
        ThrowIfFailed(DWriteCreateFactory(
            DWRITE_FACTORY_TYPE_SHARED,
            __uuidof(IDWriteFactory),
            &m_dWriteFactory));
    }

    // Query the desktop's dpi settings, which will be used to create
    // D2D's render targets.
    float dpi = GetDpiForWindow(Win32Application::GetHwnd());
    D2D1_BITMAP_PROPERTIES1 bitmapProperties = D2D1::BitmapProperties1(
        D2D1_BITMAP_OPTIONS_TARGET | D2D1_BITMAP_OPTIONS_CANNOT_DRAW,
        D2D1::PixelFormat(DXGI_FORMAT_UNKNOWN, D2D1_ALPHA_MODE_PREMULTIPLIED),
        dpi,
        dpi
        );

    // Create descriptor heaps.
    {
        // Describe and create a render target view (RTV) descriptor heap.
        D3D12_DESCRIPTOR_HEAP_DESC rtvHeapDesc = {};
        rtvHeapDesc.NumDescriptors = FrameCount;
        rtvHeapDesc.Type = D3D12_DESCRIPTOR_HEAP_TYPE_RTV;
        rtvHeapDesc.Flags = D3D12_DESCRIPTOR_HEAP_FLAG_NONE;
        ThrowIfFailed(m_d3d12Device->CreateDescriptorHeap(&rtvHeapDesc, IID_PPV_ARGS(&m_rtvHeap)));

        m_rtvDescriptorSize = 
            m_d3d12Device->GetDescriptorHandleIncrementSize(D3D12_DESCRIPTOR_HEAP_TYPE_RTV);
    }

    // Create frame resources.
    {
        CD3DX12_CPU_DESCRIPTOR_HANDLE rtvHandle(m_rtvHeap->GetCPUDescriptorHandleForHeapStart());

        // Create a RTV, D2D render target, and a command allocator for each frame.
        for (UINT n = 0; n < FrameCount; n++)
        {
            ThrowIfFailed(m_swapChain->GetBuffer(n, IID_PPV_ARGS(&m_renderTargets[n])));
            m_d3d12Device->CreateRenderTargetView(m_renderTargets[n].Get(), nullptr, rtvHandle);

            // Create a wrapped 11On12 resource of this back buffer. Since we are 
            // rendering all Direct3D 12 content first and then all D2D content, we specify 
            // the In resource state as RENDER_TARGET - because Direct3D 12 will have last 
            // used it in this state - and the Out resource state as PRESENT. When 
            // ReleaseWrappedResources() is called on the 11On12 device, the resource 
            // will be transitioned to the PRESENT state.
            D3D11_RESOURCE_FLAGS d3d11Flags = { D3D11_BIND_RENDER_TARGET };
            ThrowIfFailed(m_d3d11On12Device->CreateWrappedResource(
                m_renderTargets[n].Get(),
                &d3d11Flags,
                D3D12_RESOURCE_STATE_RENDER_TARGET,
                D3D12_RESOURCE_STATE_PRESENT,
                IID_PPV_ARGS(&m_wrappedBackBuffers[n])
                ));

            // Create a render target for D2D to draw directly to this back buffer.
            ComPtr<IDXGISurface> surface;
            ThrowIfFailed(m_wrappedBackBuffers[n].As(&surface));
            ThrowIfFailed(m_d2dDeviceContext->CreateBitmapFromDxgiSurface(
                surface.Get(),
                &bitmapProperties,
                &m_d2dRenderTargets[n]
                ));

            rtvHandle.Offset(1, m_rtvDescriptorSize);

            ThrowIfFailed(m_d3d12Device->CreateCommandAllocator(
                D3D12_COMMAND_LIST_TYPE_DIRECT,
                IID_PPV_ARGS(&m_commandAllocators[n])));
        }
    }
}

Direct3D 12 リファレンスコンテンツ内のサンプルコードに関する注意事項を参照してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での呼び出し定義

// d3d11.dll
#include <windows.h>

HRESULT D3D11On12CreateDevice(
    IUnknown* pDevice,
    DWORD Flags,
    const D3D_FEATURE_LEVEL* pFeatureLevels,   // optional
    DWORD FeatureLevels,
    IUnknown** ppCommandQueues,   // optional
    DWORD NumQueues,
    DWORD NodeMask,
    ID3D11Device** ppDevice,   // optional
    ID3D11DeviceContext** ppImmediateContext,   // optional
    D3D_FEATURE_LEVEL* pChosenFeatureLevel   // optional
);

[DllImport("d3d11.dll", ExactSpelling = true)]
static extern int D3D11On12CreateDevice(
    IntPtr pDevice,   // IUnknown*
    uint Flags,   // DWORD
    IntPtr pFeatureLevels,   // D3D_FEATURE_LEVEL* optional
    uint FeatureLevels,   // DWORD
    IntPtr ppCommandQueues,   // IUnknown** optional
    uint NumQueues,   // DWORD
    uint NodeMask,   // DWORD
    IntPtr ppDevice,   // ID3D11Device** optional, out
    IntPtr ppImmediateContext,   // ID3D11DeviceContext** optional, out
    IntPtr pChosenFeatureLevel   // D3D_FEATURE_LEVEL* optional, out
);

<DllImport("d3d11.dll", ExactSpelling:=True)>
Public Shared Function D3D11On12CreateDevice(
    pDevice As IntPtr,   ' IUnknown*
    Flags As UInteger,   ' DWORD
    pFeatureLevels As IntPtr,   ' D3D_FEATURE_LEVEL* optional
    FeatureLevels As UInteger,   ' DWORD
    ppCommandQueues As IntPtr,   ' IUnknown** optional
    NumQueues As UInteger,   ' DWORD
    NodeMask As UInteger,   ' DWORD
    ppDevice As IntPtr,   ' ID3D11Device** optional, out
    ppImmediateContext As IntPtr,   ' ID3D11DeviceContext** optional, out
    pChosenFeatureLevel As IntPtr   ' D3D_FEATURE_LEVEL* optional, out
) As Integer
End Function

' pDevice : IUnknown*
' Flags : DWORD
' pFeatureLevels : D3D_FEATURE_LEVEL* optional
' FeatureLevels : DWORD
' ppCommandQueues : IUnknown** optional
' NumQueues : DWORD
' NodeMask : DWORD
' ppDevice : ID3D11Device** optional, out
' ppImmediateContext : ID3D11DeviceContext** optional, out
' pChosenFeatureLevel : D3D_FEATURE_LEVEL* optional, out
Declare PtrSafe Function D3D11On12CreateDevice Lib "d3d11" ( _
    ByVal pDevice As LongPtr, _
    ByVal Flags As Long, _
    ByVal pFeatureLevels As LongPtr, _
    ByVal FeatureLevels As Long, _
    ByVal ppCommandQueues As LongPtr, _
    ByVal NumQueues As Long, _
    ByVal NodeMask As Long, _
    ByVal ppDevice As LongPtr, _
    ByVal ppImmediateContext As LongPtr, _
    ByVal pChosenFeatureLevel As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

D3D11On12CreateDevice = ctypes.windll.d3d11.D3D11On12CreateDevice
D3D11On12CreateDevice.restype = ctypes.c_int
D3D11On12CreateDevice.argtypes = [
    ctypes.c_void_p,  # pDevice : IUnknown*
    wintypes.DWORD,  # Flags : DWORD
    ctypes.c_void_p,  # pFeatureLevels : D3D_FEATURE_LEVEL* optional
    wintypes.DWORD,  # FeatureLevels : DWORD
    ctypes.c_void_p,  # ppCommandQueues : IUnknown** optional
    wintypes.DWORD,  # NumQueues : DWORD
    wintypes.DWORD,  # NodeMask : DWORD
    ctypes.c_void_p,  # ppDevice : ID3D11Device** optional, out
    ctypes.c_void_p,  # ppImmediateContext : ID3D11DeviceContext** optional, out
    ctypes.c_void_p,  # pChosenFeatureLevel : D3D_FEATURE_LEVEL* optional, out
]

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('d3d11.dll')
D3D11On12CreateDevice = Fiddle::Function.new(
  lib['D3D11On12CreateDevice'],
  [
    Fiddle::TYPE_VOIDP,  # pDevice : IUnknown*
    -Fiddle::TYPE_INT,  # Flags : DWORD
    Fiddle::TYPE_VOIDP,  # pFeatureLevels : D3D_FEATURE_LEVEL* optional
    -Fiddle::TYPE_INT,  # FeatureLevels : DWORD
    Fiddle::TYPE_VOIDP,  # ppCommandQueues : IUnknown** optional
    -Fiddle::TYPE_INT,  # NumQueues : DWORD
    -Fiddle::TYPE_INT,  # NodeMask : DWORD
    Fiddle::TYPE_VOIDP,  # ppDevice : ID3D11Device** optional, out
    Fiddle::TYPE_VOIDP,  # ppImmediateContext : ID3D11DeviceContext** optional, out
    Fiddle::TYPE_VOIDP,  # pChosenFeatureLevel : D3D_FEATURE_LEVEL* optional, out
  ],
  Fiddle::TYPE_INT)

#[link(name = "d3d11")]
extern "system" {
    fn D3D11On12CreateDevice(
        pDevice: *mut core::ffi::c_void,  // IUnknown*
        Flags: u32,  // DWORD
        pFeatureLevels: *const i32,  // D3D_FEATURE_LEVEL* optional
        FeatureLevels: u32,  // DWORD
        ppCommandQueues: *mut *mut core::ffi::c_void,  // IUnknown** optional
        NumQueues: u32,  // DWORD
        NodeMask: u32,  // DWORD
        ppDevice: *mut *mut core::ffi::c_void,  // ID3D11Device** optional, out
        ppImmediateContext: *mut *mut core::ffi::c_void,  // ID3D11DeviceContext** optional, out
        pChosenFeatureLevel: *mut i32  // D3D_FEATURE_LEVEL* optional, out
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[DllImport("d3d11.dll")]
public static extern int D3D11On12CreateDevice(IntPtr pDevice, uint Flags, IntPtr pFeatureLevels, uint FeatureLevels, IntPtr ppCommandQueues, uint NumQueues, uint NodeMask, IntPtr ppDevice, IntPtr ppImmediateContext, IntPtr pChosenFeatureLevel);
"@
$api = Add-Type -MemberDefinition $sig -Name 'd3d11_D3D11On12CreateDevice' -Namespace Win32 -PassThru
# $api::D3D11On12CreateDevice(pDevice, Flags, pFeatureLevels, FeatureLevels, ppCommandQueues, NumQueues, NodeMask, ppDevice, ppImmediateContext, pChosenFeatureLevel)

#uselib "d3d11.dll"
#func global D3D11On12CreateDevice "D3D11On12CreateDevice" sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr
; D3D11On12CreateDevice pDevice, Flags, varptr(pFeatureLevels), FeatureLevels, ppCommandQueues, NumQueues, NodeMask, ppDevice, ppImmediateContext, varptr(pChosenFeatureLevel)   ; 戻り値は stat
; pDevice : IUnknown* -> "sptr"
; Flags : DWORD -> "sptr"
; pFeatureLevels : D3D_FEATURE_LEVEL* optional -> "sptr"
; FeatureLevels : DWORD -> "sptr"
; ppCommandQueues : IUnknown** optional -> "sptr"
; NumQueues : DWORD -> "sptr"
; NodeMask : DWORD -> "sptr"
; ppDevice : ID3D11Device** optional, out -> "sptr"
; ppImmediateContext : ID3D11DeviceContext** optional, out -> "sptr"
; pChosenFeatureLevel : D3D_FEATURE_LEVEL* optional, out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "d3d11.dll"
#cfunc global D3D11On12CreateDevice "D3D11On12CreateDevice" sptr, int, var, int, sptr, int, int, sptr, sptr, var
; res = D3D11On12CreateDevice(pDevice, Flags, pFeatureLevels, FeatureLevels, ppCommandQueues, NumQueues, NodeMask, ppDevice, ppImmediateContext, pChosenFeatureLevel)
; pDevice : IUnknown* -> "sptr"
; Flags : DWORD -> "int"
; pFeatureLevels : D3D_FEATURE_LEVEL* optional -> "var"
; FeatureLevels : DWORD -> "int"
; ppCommandQueues : IUnknown** optional -> "sptr"
; NumQueues : DWORD -> "int"
; NodeMask : DWORD -> "int"
; ppDevice : ID3D11Device** optional, out -> "sptr"
; ppImmediateContext : ID3D11DeviceContext** optional, out -> "sptr"
; pChosenFeatureLevel : D3D_FEATURE_LEVEL* optional, out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "d3d11.dll"
#cfunc global D3D11On12CreateDevice "D3D11On12CreateDevice" sptr, int, sptr, int, sptr, int, int, sptr, sptr, sptr
; res = D3D11On12CreateDevice(pDevice, Flags, varptr(pFeatureLevels), FeatureLevels, ppCommandQueues, NumQueues, NodeMask, ppDevice, ppImmediateContext, varptr(pChosenFeatureLevel))
; pDevice : IUnknown* -> "sptr"
; Flags : DWORD -> "int"
; pFeatureLevels : D3D_FEATURE_LEVEL* optional -> "sptr"
; FeatureLevels : DWORD -> "int"
; ppCommandQueues : IUnknown** optional -> "sptr"
; NumQueues : DWORD -> "int"
; NodeMask : DWORD -> "int"
; ppDevice : ID3D11Device** optional, out -> "sptr"
; ppImmediateContext : ID3D11DeviceContext** optional, out -> "sptr"
; pChosenFeatureLevel : D3D_FEATURE_LEVEL* optional, out -> "sptr"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。