ホーム › Graphics.Direct3D11 › D3D11CreateDeviceAndSwapChain

D3D11CreateDeviceAndSwapChain

関数

Direct3D11デバイスとコンテキストおよびスワップチェーンを同時に作成する。

DLLd3d11.dll呼出規約winapi

シグネチャ

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

HRESULT D3D11CreateDeviceAndSwapChain(
    IDXGIAdapter* pAdapter,   // optional
    D3D_DRIVER_TYPE DriverType,
    HMODULE Software,
    D3D11_CREATE_DEVICE_FLAG Flags,
    const D3D_FEATURE_LEVEL* pFeatureLevels,   // optional
    DWORD FeatureLevels,
    DWORD SDKVersion,
    const DXGI_SWAP_CHAIN_DESC* pSwapChainDesc,   // optional
    IDXGISwapChain** ppSwapChain,   // optional
    ID3D11Device** ppDevice,   // optional
    D3D_FEATURE_LEVEL* pFeatureLevel,   // optional
    ID3D11DeviceContext** ppImmediateContext   // optional
);

パラメーター

名前	型	方向	説明
pAdapter	IDXGIAdapter*	inoptional	デバイスの作成時に使用するビデオアダプターへのポインター。既定のアダプター (IDXGIFactory1::EnumAdapters によって最初に列挙されるアダプター) を使用するには NULL を渡します。メモ 1 つのアプリケーション内で DXGI 1.0 (IDXGIFactory) と DXGI 1.1 (IDXGIFactory1) を混在させて使用しないでください。アプリケーションでは IDXGIFactory または IDXGIFactory1 のどちらか一方を使用し、両方を使用しないでください。
DriverType	D3D_DRIVER_TYPE	in	作成するドライバーの種類を表す D3D_DRIVER_TYPE。
Software	HMODULE	in	ソフトウェアラスタライザーを実装する DLL のハンドル。DriverType が D3D_DRIVER_TYPE_SOFTWARE の場合、Software を NULL にすることはできません。ハンドルは LoadLibrary、LoadLibraryEx、または GetModuleHandle を呼び出して取得します。この値は、D3D_DRIVER_TYPE が D3D_DRIVER_TYPE_SOFTWARE の場合は NULL 以外である必要があり、それ以外の場合は NULL にします。
Flags	D3D11_CREATE_DEVICE_FLAG	in	有効にするランタイムレイヤー (D3D11_CREATE_DEVICE_FLAG を参照)。値はビット単位の OR で組み合わせることができます。
pFeatureLevels	D3D_FEATURE_LEVEL*	inoptional	作成を試みる機能レベルの順序を決定する D3D_FEATURE_LEVEL の配列へのポインター。pFeatureLevels に NULL を設定した場合、この関数は次の機能レベルの配列を使用します。 `{ 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 11.1 ランタイムが存在し、pFeatureLevels に NULL を設定した場合、この関数は D3D_FEATURE_LEVEL_11_1 デバイスを作成しません。D3D_FEATURE_LEVEL_11_1 デバイスを作成するには、D3D_FEATURE_LEVEL_11_1 を含む D3D_FEATURE_LEVEL 配列を明示的に指定する必要があります。Direct3D 11.1 ランタイムがインストールされていないコンピューターで D3D_FEATURE_LEVEL_11_1 を含む D3D_FEATURE_LEVEL 配列を指定した場合、この関数は直ちに E_INVALIDARG で失敗します。
FeatureLevels	DWORD	in	pFeatureLevels の要素数。
SDKVersion	DWORD	in	SDK のバージョン。D3D11_SDK_VERSION を使用します。
pSwapChainDesc	DXGI_SWAP_CHAIN_DESC*	inoptional	スワップチェーンの初期化パラメーターを格納するスワップチェーンの記述 (DXGI_SWAP_CHAIN_DESC を参照) へのポインター。
ppSwapChain	IDXGISwapChain**	outoptional	レンダリングに使用されるスワップチェーンを表す IDXGISwapChain オブジェクトへのポインターのアドレスを返します。
ppDevice	ID3D11Device**	outoptional	作成されたデバイスを表す ID3D11Device オブジェクトへのポインターのアドレスを返します。このパラメーターが NULL の場合、ID3D11Device は返されません。
pFeatureLevel	D3D_FEATURE_LEVEL*	outoptional	デバイスがサポートする機能レベルの配列の最初の要素を表す D3D_FEATURE_LEVEL へのポインターを返します。どの機能レベルがサポートされているかを判断する必要がない場合は、入力として NULL を指定します。
ppImmediateContext	ID3D11DeviceContext**	outoptional	デバイスコンテキストを表す ID3D11DeviceContext オブジェクトへのポインターのアドレスを返します。このパラメーターが NULL の場合、ID3D11DeviceContext は返されません。

戻り値の型: HRESULT

公式ドキュメント

ディスプレイアダプターを表すデバイスと、レンダリングに使用するスワップチェーンを作成します。

戻り値

種類: HRESULT

このメソッドは、Direct3D 11 の戻り値コードのいずれかを返すことがあります。

セッション 0 のプロセスでこのメソッドを呼び出した場合は、DXGI_ERROR_NOT_CURRENTLY_AVAILABLE が返されます。

pAdapter パラメーターに NULL 以外の値を設定し、DriverType パラメーターに D3D_DRIVER_TYPE_HARDWARE 値を設定した場合、このメソッドは E_INVALIDARG を返します。

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

解説(Remarks)

メモセッション 0 のプロセスでこのメソッドを呼び出した場合は、DXGI_ERROR_NOT_CURRENTLY_AVAILABLE が返されます。

このエントリポイントは Direct3D 11 ランタイムでサポートされます。Direct3D 11 ランタイムは Windows 7 および Windows Server 2008 R2 で利用でき、Windows Vista では更新プログラム (KB971644) として利用できます。

Direct3D 11.1 デバイス (ID3D11Device1) は、Windows 8、Windows Server 2012、および Windows 7 用のプラットフォーム更新プログラムがインストールされた Windows 7 と Windows Server 2008 R2 で利用できます。これを作成するには、まずこの関数で ID3D11Device を作成し、次に ID3D11Device オブジェクトに対して QueryInterface メソッドを呼び出して ID3D11Device1 インターフェイスを取得します。

Direct3D 11.2 デバイス (ID3D11Device2) は、Windows 8.1 および Windows Server 2012 R2 で利用できます。これを作成するには、まずこの関数で ID3D11Device を作成し、次に ID3D11Device オブジェクトに対して QueryInterface メソッドを呼び出して ID3D11Device2 インターフェイスを取得します。

また、入力パラメーターの依存関係の詳細については、D3D11CreateDevice の解説セクションを参照してください。スワップチェーンを作成せずにデバイスのみを作成するには、D3D11CreateDevice 関数を使用します。

pAdapter パラメーターに NULL 以外の値を設定する場合は、DriverType パラメーターにも D3D_DRIVER_TYPE_UNKNOWN 値を設定する必要があります。pAdapter パラメーターに NULL 以外の値を設定し、DriverType パラメーターに D3D_DRIVER_TYPE_HARDWARE 値を設定した場合、D3D11CreateDeviceAndSwapChain は E_INVALIDARG の HRESULT を返します。

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

使用上の注意

メモ D3D11CreateDeviceAndSwapChain 関数は Windows ストアアプリには存在しません。代わりに、Windows ストアアプリでは D3D11CreateDevice 関数を使用し、続いて IDXGIFactory2::CreateSwapChainForCoreWindow メソッドを使用します。

メモこの関数は、最近追加されたスワップチェーン作成の機能に対応するようには更新されていません。最新のスワップチェーン作成方法については、IDXGIFactory2 のメソッド (CreateSwapChainForHwnd、CreateSwapChainForCoreWindow、CreateSwapChainForComposition など) を参照してください。

Windows Phone 8: この API はサポートされています。

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

各言語での呼び出し定義

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

HRESULT D3D11CreateDeviceAndSwapChain(
    IDXGIAdapter* pAdapter,   // optional
    D3D_DRIVER_TYPE DriverType,
    HMODULE Software,
    D3D11_CREATE_DEVICE_FLAG Flags,
    const D3D_FEATURE_LEVEL* pFeatureLevels,   // optional
    DWORD FeatureLevels,
    DWORD SDKVersion,
    const DXGI_SWAP_CHAIN_DESC* pSwapChainDesc,   // optional
    IDXGISwapChain** ppSwapChain,   // optional
    ID3D11Device** ppDevice,   // optional
    D3D_FEATURE_LEVEL* pFeatureLevel,   // optional
    ID3D11DeviceContext** ppImmediateContext   // optional
);

[DllImport("d3d11.dll", ExactSpelling = true)]
static extern int D3D11CreateDeviceAndSwapChain(
    IntPtr pAdapter,   // IDXGIAdapter* optional
    int DriverType,   // D3D_DRIVER_TYPE
    IntPtr Software,   // HMODULE
    uint Flags,   // D3D11_CREATE_DEVICE_FLAG
    IntPtr pFeatureLevels,   // D3D_FEATURE_LEVEL* optional
    uint FeatureLevels,   // DWORD
    uint SDKVersion,   // DWORD
    IntPtr pSwapChainDesc,   // DXGI_SWAP_CHAIN_DESC* optional
    IntPtr ppSwapChain,   // IDXGISwapChain** optional, out
    IntPtr ppDevice,   // ID3D11Device** optional, out
    IntPtr pFeatureLevel,   // D3D_FEATURE_LEVEL* optional, out
    IntPtr ppImmediateContext   // ID3D11DeviceContext** optional, out
);

<DllImport("d3d11.dll", ExactSpelling:=True)>
Public Shared Function D3D11CreateDeviceAndSwapChain(
    pAdapter As IntPtr,   ' IDXGIAdapter* optional
    DriverType As Integer,   ' D3D_DRIVER_TYPE
    Software As IntPtr,   ' HMODULE
    Flags As UInteger,   ' D3D11_CREATE_DEVICE_FLAG
    pFeatureLevels As IntPtr,   ' D3D_FEATURE_LEVEL* optional
    FeatureLevels As UInteger,   ' DWORD
    SDKVersion As UInteger,   ' DWORD
    pSwapChainDesc As IntPtr,   ' DXGI_SWAP_CHAIN_DESC* optional
    ppSwapChain As IntPtr,   ' IDXGISwapChain** optional, out
    ppDevice As IntPtr,   ' ID3D11Device** optional, out
    pFeatureLevel As IntPtr,   ' D3D_FEATURE_LEVEL* optional, out
    ppImmediateContext As IntPtr   ' ID3D11DeviceContext** optional, out
) As Integer
End Function

' pAdapter : IDXGIAdapter* optional
' DriverType : D3D_DRIVER_TYPE
' Software : HMODULE
' Flags : D3D11_CREATE_DEVICE_FLAG
' pFeatureLevels : D3D_FEATURE_LEVEL* optional
' FeatureLevels : DWORD
' SDKVersion : DWORD
' pSwapChainDesc : DXGI_SWAP_CHAIN_DESC* optional
' ppSwapChain : IDXGISwapChain** optional, out
' ppDevice : ID3D11Device** optional, out
' pFeatureLevel : D3D_FEATURE_LEVEL* optional, out
' ppImmediateContext : ID3D11DeviceContext** optional, out
Declare PtrSafe Function D3D11CreateDeviceAndSwapChain Lib "d3d11" ( _
    ByVal pAdapter As LongPtr, _
    ByVal DriverType As Long, _
    ByVal Software As LongPtr, _
    ByVal Flags As Long, _
    ByVal pFeatureLevels As LongPtr, _
    ByVal FeatureLevels As Long, _
    ByVal SDKVersion As Long, _
    ByVal pSwapChainDesc As LongPtr, _
    ByVal ppSwapChain As LongPtr, _
    ByVal ppDevice As LongPtr, _
    ByVal pFeatureLevel As LongPtr, _
    ByVal ppImmediateContext As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

D3D11CreateDeviceAndSwapChain = ctypes.windll.d3d11.D3D11CreateDeviceAndSwapChain
D3D11CreateDeviceAndSwapChain.restype = ctypes.c_int
D3D11CreateDeviceAndSwapChain.argtypes = [
    ctypes.c_void_p,  # pAdapter : IDXGIAdapter* optional
    ctypes.c_int,  # DriverType : D3D_DRIVER_TYPE
    wintypes.HANDLE,  # Software : HMODULE
    wintypes.DWORD,  # Flags : D3D11_CREATE_DEVICE_FLAG
    ctypes.c_void_p,  # pFeatureLevels : D3D_FEATURE_LEVEL* optional
    wintypes.DWORD,  # FeatureLevels : DWORD
    wintypes.DWORD,  # SDKVersion : DWORD
    ctypes.c_void_p,  # pSwapChainDesc : DXGI_SWAP_CHAIN_DESC* optional
    ctypes.c_void_p,  # ppSwapChain : IDXGISwapChain** optional, out
    ctypes.c_void_p,  # ppDevice : ID3D11Device** optional, out
    ctypes.c_void_p,  # pFeatureLevel : D3D_FEATURE_LEVEL* optional, out
    ctypes.c_void_p,  # ppImmediateContext : ID3D11DeviceContext** optional, out
]

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('d3d11.dll')
D3D11CreateDeviceAndSwapChain = Fiddle::Function.new(
  lib['D3D11CreateDeviceAndSwapChain'],
  [
    Fiddle::TYPE_VOIDP,  # pAdapter : IDXGIAdapter* optional
    Fiddle::TYPE_INT,  # DriverType : D3D_DRIVER_TYPE
    Fiddle::TYPE_VOIDP,  # Software : HMODULE
    -Fiddle::TYPE_INT,  # Flags : D3D11_CREATE_DEVICE_FLAG
    Fiddle::TYPE_VOIDP,  # pFeatureLevels : D3D_FEATURE_LEVEL* optional
    -Fiddle::TYPE_INT,  # FeatureLevels : DWORD
    -Fiddle::TYPE_INT,  # SDKVersion : DWORD
    Fiddle::TYPE_VOIDP,  # pSwapChainDesc : DXGI_SWAP_CHAIN_DESC* optional
    Fiddle::TYPE_VOIDP,  # ppSwapChain : IDXGISwapChain** optional, out
    Fiddle::TYPE_VOIDP,  # ppDevice : ID3D11Device** optional, out
    Fiddle::TYPE_VOIDP,  # pFeatureLevel : D3D_FEATURE_LEVEL* optional, out
    Fiddle::TYPE_VOIDP,  # ppImmediateContext : ID3D11DeviceContext** optional, out
  ],
  Fiddle::TYPE_INT)

#[link(name = "d3d11")]
extern "system" {
    fn D3D11CreateDeviceAndSwapChain(
        pAdapter: *mut core::ffi::c_void,  // IDXGIAdapter* optional
        DriverType: i32,  // D3D_DRIVER_TYPE
        Software: *mut core::ffi::c_void,  // HMODULE
        Flags: u32,  // D3D11_CREATE_DEVICE_FLAG
        pFeatureLevels: *const i32,  // D3D_FEATURE_LEVEL* optional
        FeatureLevels: u32,  // DWORD
        SDKVersion: u32,  // DWORD
        pSwapChainDesc: *const DXGI_SWAP_CHAIN_DESC,  // DXGI_SWAP_CHAIN_DESC* optional
        ppSwapChain: *mut *mut core::ffi::c_void,  // IDXGISwapChain** optional, out
        ppDevice: *mut *mut core::ffi::c_void,  // ID3D11Device** optional, out
        pFeatureLevel: *mut i32,  // D3D_FEATURE_LEVEL* optional, out
        ppImmediateContext: *mut *mut core::ffi::c_void  // ID3D11DeviceContext** optional, out
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[DllImport("d3d11.dll")]
public static extern int D3D11CreateDeviceAndSwapChain(IntPtr pAdapter, int DriverType, IntPtr Software, uint Flags, IntPtr pFeatureLevels, uint FeatureLevels, uint SDKVersion, IntPtr pSwapChainDesc, IntPtr ppSwapChain, IntPtr ppDevice, IntPtr pFeatureLevel, IntPtr ppImmediateContext);
"@
$api = Add-Type -MemberDefinition $sig -Name 'd3d11_D3D11CreateDeviceAndSwapChain' -Namespace Win32 -PassThru
# $api::D3D11CreateDeviceAndSwapChain(pAdapter, DriverType, Software, Flags, pFeatureLevels, FeatureLevels, SDKVersion, pSwapChainDesc, ppSwapChain, ppDevice, pFeatureLevel, ppImmediateContext)

#uselib "d3d11.dll"
#func global D3D11CreateDeviceAndSwapChain "D3D11CreateDeviceAndSwapChain" sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr
; D3D11CreateDeviceAndSwapChain pAdapter, DriverType, Software, Flags, varptr(pFeatureLevels), FeatureLevels, SDKVersion, varptr(pSwapChainDesc), ppSwapChain, ppDevice, varptr(pFeatureLevel), ppImmediateContext   ; 戻り値は stat
; pAdapter : IDXGIAdapter* optional -> "sptr"
; DriverType : D3D_DRIVER_TYPE -> "sptr"
; Software : HMODULE -> "sptr"
; Flags : D3D11_CREATE_DEVICE_FLAG -> "sptr"
; pFeatureLevels : D3D_FEATURE_LEVEL* optional -> "sptr"
; FeatureLevels : DWORD -> "sptr"
; SDKVersion : DWORD -> "sptr"
; pSwapChainDesc : DXGI_SWAP_CHAIN_DESC* optional -> "sptr"
; ppSwapChain : IDXGISwapChain** optional, out -> "sptr"
; ppDevice : ID3D11Device** optional, out -> "sptr"
; pFeatureLevel : D3D_FEATURE_LEVEL* optional, out -> "sptr"
; ppImmediateContext : ID3D11DeviceContext** optional, out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "d3d11.dll"
#cfunc global D3D11CreateDeviceAndSwapChain "D3D11CreateDeviceAndSwapChain" sptr, int, sptr, int, var, int, int, var, sptr, sptr, var, sptr
; res = D3D11CreateDeviceAndSwapChain(pAdapter, DriverType, Software, Flags, pFeatureLevels, FeatureLevels, SDKVersion, pSwapChainDesc, ppSwapChain, ppDevice, pFeatureLevel, ppImmediateContext)
; pAdapter : IDXGIAdapter* optional -> "sptr"
; DriverType : D3D_DRIVER_TYPE -> "int"
; Software : HMODULE -> "sptr"
; Flags : D3D11_CREATE_DEVICE_FLAG -> "int"
; pFeatureLevels : D3D_FEATURE_LEVEL* optional -> "var"
; FeatureLevels : DWORD -> "int"
; SDKVersion : DWORD -> "int"
; pSwapChainDesc : DXGI_SWAP_CHAIN_DESC* optional -> "var"
; ppSwapChain : IDXGISwapChain** optional, out -> "sptr"
; ppDevice : ID3D11Device** optional, out -> "sptr"
; pFeatureLevel : D3D_FEATURE_LEVEL* optional, out -> "var"
; ppImmediateContext : ID3D11DeviceContext** optional, out -> "sptr"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "d3d11.dll"
#cfunc global D3D11CreateDeviceAndSwapChain "D3D11CreateDeviceAndSwapChain" sptr, int, sptr, int, sptr, int, int, sptr, sptr, sptr, sptr, sptr
; res = D3D11CreateDeviceAndSwapChain(pAdapter, DriverType, Software, Flags, varptr(pFeatureLevels), FeatureLevels, SDKVersion, varptr(pSwapChainDesc), ppSwapChain, ppDevice, varptr(pFeatureLevel), ppImmediateContext)
; pAdapter : IDXGIAdapter* optional -> "sptr"
; DriverType : D3D_DRIVER_TYPE -> "int"
; Software : HMODULE -> "sptr"
; Flags : D3D11_CREATE_DEVICE_FLAG -> "int"
; pFeatureLevels : D3D_FEATURE_LEVEL* optional -> "sptr"
; FeatureLevels : DWORD -> "int"
; SDKVersion : DWORD -> "int"
; pSwapChainDesc : DXGI_SWAP_CHAIN_DESC* optional -> "sptr"
; ppSwapChain : IDXGISwapChain** optional, out -> "sptr"
; ppDevice : ID3D11Device** optional, out -> "sptr"
; pFeatureLevel : D3D_FEATURE_LEVEL* optional, out -> "sptr"
; ppImmediateContext : ID3D11DeviceContext** optional, out -> "sptr"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。