IDXGIFactory2

IDXGIFactory2 インターフェイスには、IDXGISwapChain よりも多くの機能を持つ新しいバージョンのスワップチェーンを作成するメソッドや、ステレオスコピック 3D 機能を監視するメソッドが含まれます。

Microsoft DirectX Graphics Infrastructure (DXGI) 1.2 のファクトリインターフェイスを作成するには、IDXGIFactory2 を CreateDXGIFactory または CreateDXGIFactory1 関数に渡すか、CreateDXGIFactory または CreateDXGIFactory1 が返すファクトリオブジェクトに対して QueryInterface を呼び出します。

スワップチェーンを作成せずに Direct3D デバイスを作成できるため、スワップチェーンを作成するには、そのデバイスの作成に使用されたファクトリを取得する必要がある場合があります。 Direct3D デバイスから IDXGIDevice、IDXGIDevice1、または IDXGIDevice2 インターフェイスを要求し、IDXGIObject::GetParent メソッドを使用してファクトリを見つけることができます。次のコードにその方法を示します。

IDXGIDevice2 * pDXGIDevice;
hr = g_pd3dDevice->QueryInterface(__uuidof(IDXGIDevice2), (void **)&pDXGIDevice);
      
IDXGIAdapter * pDXGIAdapter;
hr = pDXGIDevice->GetParent(__uuidof(IDXGIAdapter), (void **)&pDXGIAdapter);

IDXGIFactory2 * pIDXGIFactory;
pDXGIAdapter->GetParent(__uuidof(IDXGIFactory2), (void **)&pIDXGIFactory);

ステレオモードを使用するかどうかを判断します。

ステレオモードを使用するかどうかを示します。TRUE はステレオモードを使用できることを示し、そうでない場合は FALSE です。

Platform Update for Windows 7: Platform Update for Windows 7 がインストールされた Windows 7 または Windows Server 2008 R2 では、Platform Update for Windows 7 でステレオスコピック 3D 表示の動作が利用できないため、IsWindowedStereoEnabled は常に FALSE を返します。Platform Update for Windows 7 の詳細については、Platform Update for Windows 7 を参照してください。

ウィンドウ表示のアプリケーションでは、ステレオを使用する前に IsWindowedStereoEnabled を呼び出すことをお勧めします。IsWindowedStereoEnabled は、次の両方の項目が真である場合に TRUE を返します。

• コンピューター内のすべてのアダプターが、ステレオに対応したドライバーを備えている。これは、そのドライバーが Windows 8 向けの Windows Display Driver Model (WDDM)(WDDM 1.2)に準拠して実装されていることを意味するにすぎません。ただし、アダプターが必ずしもステレオをスキャンアウトできる必要はありません。
• 現在のデスクトップモード(デスクトップモードは単眼)、システムポリシー、およびハードウェアが、Desktop Window Manager (DWM) が少なくとも 1 つのアダプター出力(アウトプット)でステレオ合成を実行するように構成されている。

最初の要件が満たされていれば、ウィンドウ表示のステレオスワップチェーンの作成は成功します。ただし、アダプターがステレオをスキャンアウトできない場合、そのアダプターの出力(アウトプット)は単眼に縮退します。

Direct3D 11.1 Simple Stereo 3D Sample は、ステレオスコピック 3D 効果を追加する方法と、システムのステレオ変更に応答する方法を示しています。

スワップチェーンの出力ウィンドウへの HWND ハンドルに関連付けられたスワップチェーンを作成します。

CreateSwapChainForHwnd は次を返します。

• スワップチェーンの作成に成功した場合は S_OK。
• 操作を完了するためのメモリが利用できない場合は E_OUTOFMEMORY。
• 呼び出し元のアプリケーションが無効なデータを渡した場合(たとえば pDesc または ppSwapChain が NULL の場合、または pDesc のデータメンバーが無効な場合)は DXGI_ERROR_INVALID_CALL。
• pDevice に渡すデバイスの種類によって定義される、DXGI_ERROR トピックで説明されているその他のエラーコードが返される場合があります。

Platform Update for Windows 7: Platform Update for Windows 7 がインストールされた Windows 7 または Windows Server 2008 R2 では DXGI_SCALING_NONE はサポートされておらず、呼び出すと CreateSwapChainForHwnd は DXGI_ERROR_INVALID_CALL を返します。Platform Update for Windows 7 の詳細については、Platform Update for Windows 7 を参照してください。

スワップチェーンの幅、高さ、またはその両方(pDesc が指す DXGI_SWAP_CHAIN_DESC1 の Width および Height メンバー)をゼロに指定した場合、ランタイムは hWnd パラメーターで指定された出力ウィンドウからサイズを取得します。

その後、IDXGISwapChain1::GetDesc1 メソッドを呼び出して、割り当てられた幅または高さの値を取得できます。

1 つの HWND には一度に 1 つのフリップ表示(プレゼント)モデルのスワップチェーンしか関連付けられないため、フリップ表示(プレゼント)モデルのスワップチェーンを破棄して別のスワップチェーンに置き換えようとすると、オブジェクトの破棄を遅延させる Microsoft Direct3D 11 のポリシーが問題を引き起こすことがあります。この状況の詳細については、Deferred Destruction Issues with Flip Presentation Swap Chains を参照してください。

スワップチェーンのバックバッファーのフォーマットを選択する方法については、Converting data for the color space を参照してください。

スワップチェーンの出力ウィンドウ用の CoreWindow オブジェクトに関連付けられたスワップチェーンを作成します。

CreateSwapChainForCoreWindow は次を返します。

• スワップチェーンの作成に成功した場合は S_OK。
• 操作を完了するためのメモリが利用できない場合は E_OUTOFMEMORY。
• 呼び出し元のアプリケーションが無効なデータを渡した場合(たとえば pDesc または ppSwapChain が NULL の場合)は DXGI_ERROR_INVALID_CALL。
• pDevice に渡すデバイスの種類によって定義される、DXGI_ERROR トピックで説明されているその他のエラーコードが返される場合があります。

Platform Update for Windows 7: Platform Update for Windows 7 がインストールされた Windows 7 または Windows Server 2008 R2 では、CreateSwapChainForCoreWindow は E_NOTIMPL で失敗します。Platform Update for Windows 7 の詳細については、Platform Update for Windows 7 を参照してください。

スワップチェーンの幅、高さ、またはその両方(pDesc が指す DXGI_SWAP_CHAIN_DESC1 の Width および Height メンバー)をゼロに指定した場合、ランタイムは pWindow パラメーターで指定された出力ウィンドウからサイズを取得します。

その後、IDXGISwapChain1::GetDesc1 メソッドを呼び出して、割り当てられた幅または高さの値を取得できます。

1 つの CoreWindow には(レイヤーごとに)一度に 1 つのフリップ表示(プレゼント)モデルのスワップチェーンしか関連付けられないため、フリップ表示(プレゼント)モデルのスワップチェーンを破棄して別のスワップチェーンに置き換えようとすると、オブジェクトの破棄を遅延させる Microsoft Direct3D 11 のポリシーが問題を引き起こすことがあります。この状況の詳細については、Deferred Destruction Issues with Flip Presentation Swap Chains を参照してください。

スワップチェーンのバックバッファーのフォーマットを選択する方法については、Converting data for the color space を参照してください。

重なり合うスワップチェーン

Windows 8.1 以降では、前景レイヤーに追加のスワップチェーンを作成できます。前景スワップチェーンを使用すると、背景スワップチェーンでリアルタイムレンダリング(ゲームプレイなど)をスケールアップしつつ、UI 要素をネイティブ解像度でレンダリングできます。これにより、より速いフィルレートのために低解像度レンダリングが必要でありながら、UI の品質を犠牲にしないシナリオが可能になります。

前景スワップチェーンは、pDesc が指す DXGI_SWAP_CHAIN_DESC1 で DXGI_SWAP_CHAIN_FLAG_FOREGROUND_LAYER スワップチェーンフラグを設定して作成します。前景スワップチェーンは、DXGI_ALPHA_MODE_PREMULTIPLIED アルファモードも使用する必要があり、また DXGI_SCALING_NONE を使用する必要があります。乗算済みアルファとは、フレームが表示(プレゼント)される前に、各ピクセルの色の値がすでにアルファ値で乗算されていることが期待されることを意味します。たとえば、アルファ 50% の 100% 白の BGRA ピクセルは (0.5, 0.5, 0.5, 0.5) に設定されます。アルファの事前乗算のステップは、D3D11_RENDER_TARGET_BLEND_DESC 構造体の SrcBlend フィールドを D3D11_SRC_ALPHA に設定したアプリのブレンドステート(ID3D11BlendState を参照)を適用することで、出力マージャーステージで実行できます。アルファの事前乗算のステップを行わないと、前景スワップチェーンの色は予期したよりも明るくなります。

前景スワップチェーンは、ハードウェアがサポートしている場合はマルチプレーンオーバーレイを使用します。IDXGIOutput2::SupportsOverlays を呼び出して、アダプターのオーバーレイサポートを照会してください。

次の例は、CoreWindow 用の前景スワップチェーンを作成します。

DXGI_SWAP_CHAIN_DESC1 swapChainDesc = { 0 };

swapChainDesc.Width = static_cast<UINT>(m_d3dRenderTargetSize.Width);
swapChainDesc.Height = static_cast<UINT>(m_d3dRenderTargetSize.Height);
swapChainDesc.Format = DXGI_FORMAT_B8G8R8A8_UNORM;
swapChainDesc.Stereo = false;
swapChainDesc.SampleDesc.Count = 1; // Don't use multi-sampling.
swapChainDesc.SampleDesc.Quality = 0;
swapChainDesc.BufferUsage = DXGI_USAGE_RENDER_TARGET_OUTPUT;
swapChainDesc.BufferCount = 2;
swapChainDesc.SwapEffect = DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL;
swapChainDesc.Flags = DXGI_SWAP_CHAIN_FLAG_FOREGROUND_LAYER;
swapChainDesc.AlphaMode = DXGI_ALPHA_MODE_PREMULTIPLIED;
swapChainDesc.Scaling = DXGI_SCALING_NONE;

ComPtr<IDXGISwapChain1> swapChain;
HRESULT hr = dxgiFactory->CreateSwapChainForCoreWindow(
    m_d3dDevice.Get(),
    reinterpret_cast<IUnknown*>(m_window.Get()),
    &swapChainDesc,
    nullptr,
    &swapChain
    );

レンダリングが完了したら、両方のスワップチェーンを一緒に表示(プレゼント)します。

次の例は、両方のスワップチェーンを表示(プレゼント)します。

HRESULT hr = m_swapChain->Present(1, 0);

if (SUCCEEDED(hr) && m_foregroundSwapChain)
{
    m_foregroundSwapChain->Present(1, 0);
}

共有リソースオブジェクトが作成されたアダプターを識別します。

GetSharedResourceAdapterLuid は次を返します。

• アダプターを識別した場合は S_OK。
• hResource が無効な場合は DXGI_ERROR_INVALID_CALL。
• DXGI_ERROR トピックで説明されているその他のエラーコードが返される場合があります。

Platform Update for Windows 7: Platform Update for Windows 7 がインストールされた Windows 7 または Windows Server 2008 R2 では、GetSharedResourceAdapterLuid は E_NOTIMPL で失敗します。Platform Update for Windows 7 の詳細については、Platform Update for Windows 7 を参照してください。

アダプターをまたいでリソースを共有することはできません。したがって、リソースが作成されたアダプター以外のアダプターで共有リソースを開くことはできません。共有リソースを開く前に GetSharedResourceAdapterLuid を呼び出して、リソースが適切なアダプターで作成されたことを確認してください。共有リソースを開くには、ID3D11Device1::OpenSharedResource1 または ID3D11Device1::OpenSharedResourceByName メソッドを呼び出します。

例

HANDLE handle;
IDXGIFactory2* pFactory;

LUID luid;
pFactory->GetSharedResourceAdapterLuid (handle, &luid);

UINT index = 0;
IDXGIAdapter* pAdapter = NULL;
while (SUCCEEDED(pFactory->EnumAdapters(index, &pAdapter)))
{
    DXGI_ADAPTER_DESC desc;
    pAdapter->GetDesc(&desc);
    if (desc.AdapterLuid == luid)
    {
       // Identified a matching adapter.
       break;
    }
    pAdapter->Release();
    pAdapter = NULL;
    index++;
}
// At this point, if pAdapter is non-null, you identified an adapter that 
// can open the shared resource.

ステレオ状態の変化の通知メッセージを受け取るために、アプリケーションウィンドウを登録します。

RegisterStereoStatusWindow は次を返します。

• ウィンドウの登録に成功した場合は S_OK。
• 操作を完了するためのメモリが利用できない場合は E_OUTOFMEMORY。
• DXGI_ERROR トピックで説明されているその他のエラーコードが返される場合があります。

Platform Update for Windows 7: Platform Update for Windows 7 がインストールされた Windows 7 または Windows Server 2008 R2 では、RegisterStereoStatusWindow は E_NOTIMPL で失敗します。Platform Update for Windows 7 の詳細については、Platform Update for Windows 7 を参照してください。

イベントシグナルを使用して、ステレオ状態の変化の通知を受け取るために登録します。

RegisterStereoStatusEvent は次を返します。

• イベントの登録に成功した場合は S_OK。
• 操作を完了するためのメモリが利用できない場合は E_OUTOFMEMORY。
• DXGI_ERROR トピックで説明されているその他のエラーコードが返される場合があります。

Platform Update for Windows 7: Platform Update for Windows 7 がインストールされた Windows 7 または Windows Server 2008 R2 では、RegisterStereoStatusEvent は E_NOTIMPL で失敗します。Platform Update for Windows 7 の詳細については、Platform Update for Windows 7 を参照してください。

ステレオ状態が変化したときに通知を受け取らないように、ウィンドウまたはイベントの登録を解除します。

Platform Update for Windows 7: Platform Update for Windows 7 がインストールされた Windows 7 または Windows Server 2008 R2 では、UnregisterStereoStatus は効果がありません。Platform Update for Windows 7 の詳細については、Platform Update for Windows 7 を参照してください。

オクルージョン状態の変化の通知メッセージを受け取るために、アプリケーションウィンドウを登録します。

RegisterOcclusionStatusWindow は次を返します。

• ウィンドウの登録に成功した場合は S_OK。
• 操作を完了するためのメモリが利用できない場合は E_OUTOFMEMORY。
• WindowHandle が有効なウィンドウハンドルでない場合、または現在のプロセスが所有するウィンドウハンドルでない場合は DXGI_ERROR_INVALID_CALL。
• DXGI_ERROR トピックで説明されているその他のエラーコードが返される場合があります。

Platform Update for Windows 7: Platform Update for Windows 7 がインストールされた Windows 7 または Windows Server 2008 R2 では、RegisterOcclusionStatusWindow は E_NOTIMPL で失敗します。Platform Update for Windows 7 の詳細については、Platform Update for Windows 7 を参照してください。

アプリは、オクルージョン状態が変化したときに Windows が送信する Windows メッセージを選択します。

イベントシグナルを使用して、オクルージョン状態の変化の通知を受け取るために登録します。

RegisterOcclusionStatusEvent は次を返します。

• メソッドがイベントの登録に成功した場合は S_OK。
• 操作を完了するためのメモリが利用できない場合は E_OUTOFMEMORY。
• hEvent が有効なハンドルでない場合、またはイベントハンドルでない場合は DXGI_ERROR_INVALID_CALL。
• DXGI_ERROR トピックで説明されているその他のエラーコードが返される場合があります。

Platform Update for Windows 7: Platform Update for Windows 7 がインストールされた Windows 7 または Windows Server 2008 R2 では、RegisterOcclusionStatusEvent は E_NOTIMPL で失敗します。Platform Update for Windows 7 の詳細については、Platform Update for Windows 7 を参照してください。

同じイベントハンドルで RegisterOcclusionStatusEvent を複数回呼び出した場合、RegisterOcclusionStatusEvent は DXGI_ERROR_INVALID_CALL で失敗します。

異なるイベントハンドルで RegisterOcclusionStatusEvent を複数回呼び出した場合、RegisterOcclusionStatusEvent はイベントを適切に登録します。

オクルージョン状態が変化したときに通知を受け取らないように、ウィンドウまたはイベントの登録を解除します。

Platform Update for Windows 7: Platform Update for Windows 7 がインストールされた Windows 7 または Windows Server 2008 R2 では、UnregisterOcclusionStatus は効果がありません。Platform Update for Windows 7 の詳細については、Platform Update for Windows 7 を参照してください。

Direct3D のコンテンツを DirectComposition API または Xaml フレームワークに送信してウィンドウ内で合成するために使用できるスワップチェーンを作成します。

CreateSwapChainForComposition は次を返します。

• スワップチェーンの作成に成功した場合は S_OK。
• 操作を完了するためのメモリが利用できない場合は E_OUTOFMEMORY。
• 呼び出し元のアプリケーションが無効なデータを渡した場合(たとえば pDesc または ppSwapChain が NULL の場合)は DXGI_ERROR_INVALID_CALL。
• pDevice に渡すデバイスの種類によって定義される、DXGI_ERROR トピックで説明されているその他のエラーコードが返される場合があります。

Platform Update for Windows 7: Platform Update for Windows 7 がインストールされた Windows 7 または Windows Server 2008 R2 では、CreateSwapChainForComposition は E_NOTIMPL で失敗します。Platform Update for Windows 7 の詳細については、Platform Update for Windows 7 を参照してください。

合成スワップチェーンは、次のいずれかと共に使用できます。

• DirectComposition の IDCompositionVisual インターフェイス。
• システム XAML の SwapChainPanel または SwapChainBackgroundPanel クラス。
• Windows UI Library (WinUI) 3 XAML の SwapChainPanel または SwapChainBackgroundPanel クラス。

DirectComposition では、IDCompositionVisual::SetContent メソッドを呼び出してスワップチェーンをビジュアルオブジェクトのコンテンツとして設定でき、これによってスワップチェーンをビジュアルツリーにバインドできます。XAML では、SwapChainBackgroundPanel クラスがクラシックな COM インターフェイス ISwapChainBackgroundPanelNative を公開します。ISwapChainBackgroundPanelNative::SetSwapChain メソッドを使用して XAML UI グラフにバインドできます。XAML の SwapChainBackgroundPanel クラスで合成スワップチェーンを使用する方法については、DirectX and XAML interop を参照してください。

IDXGISwapChain::SetFullscreenState、IDXGISwapChain::ResizeTarget、IDXGISwapChain::GetContainingOutput、IDXGISwapChain1::GetHwnd、および IDXGISwapChain::GetCoreWindow の各メソッドは、この種類のスワップチェーンでは有効ではありません。この種類のスワップチェーンでこれらのメソッドのいずれかを呼び出すと、失敗します。

スワップチェーンのバックバッファーのフォーマットを選択する方法については、Converting data for the color space を参照してください。

例

CreateSwapChainForComposition の使用方法を示すコード例については、SwapChainPanel and gaming を参照してください。

• WinRT XAML では、ISwapChainPanelNative および ISwapChainBackgroundPanelNative インターフェイスは windows.ui.xaml.media.dxinterop.h ヘッダーで宣言されています。
• Windows UI Library (WinUI) XAML では、ISwapChainPanelNative および ISwapChainBackgroundPanelNative インターフェイスは microsoft.ui.xaml.media.dxinterop.h ヘッダーで宣言されています。

#define global IID_IDXGIFactory2 "{50C83A1C-E072-4C48-87B0-3630FA36A6D0}"
#usecom global IDXGIFactory2 IID_IDXGIFactory2 "{}"
#comfunc global IDXGIFactory2_IsWindowedStereoEnabled        14
#comfunc global IDXGIFactory2_CreateSwapChainForHwnd         15 sptr,sptr,var,var,sptr,sptr
#comfunc global IDXGIFactory2_CreateSwapChainForCoreWindow   16 sptr,sptr,var,sptr,sptr
#comfunc global IDXGIFactory2_GetSharedResourceAdapterLuid   17 sptr,var
#comfunc global IDXGIFactory2_RegisterStereoStatusWindow     18 sptr,int,var
#comfunc global IDXGIFactory2_RegisterStereoStatusEvent      19 sptr,var
#comfunc global IDXGIFactory2_UnregisterStereoStatus         20 int
#comfunc global IDXGIFactory2_RegisterOcclusionStatusWindow  21 sptr,int,var
#comfunc global IDXGIFactory2_RegisterOcclusionStatusEvent   22 sptr,var
#comfunc global IDXGIFactory2_UnregisterOcclusionStatus      23 int
#comfunc global IDXGIFactory2_CreateSwapChainForComposition  24 sptr,var,sptr,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。