DXGI_SWAP_EFFECT列挙 (dxgi.h)

IDXGISwapChain1::P resent1 を呼び出した後の表示サーフェイスのピクセルを処理するためのオプション。

構文

typedef enum DXGI_SWAP_EFFECT {
  DXGI_SWAP_EFFECT_DISCARD = 0,
  DXGI_SWAP_EFFECT_SEQUENTIAL = 1,
  DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL = 3,
  DXGI_SWAP_EFFECT_FLIP_DISCARD = 4
} ;

定数

注釈

この列挙は、 DXGI_SWAP_CHAIN_DESC および DXGI_SWAP_CHAIN_DESC1 構造体によって使用されます。

D3D12 では、 DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL と DXGI_SWAP_EFFECT_FLIP_DISCARD のみがサポートされ、ビットブル モデルはサポートされていません。 このため、D3D12 ではバック バッファーのマルチサンプリングはサポートされていないため、 ID3D12GraphicsCommandList::ResolveSubresource または ID3D12GraphicsCommandList1::ResolveSubresourceRegion を使用して、アプリで手動でマルチサンプリングを実行する必要があります。

DXGI_SWAP_EFFECT_SEQUENTIALまたはDXGI_SWAP_EFFECT_FLIP_SEQUENTIALでマルチサンプリングを使用するには、別のレンダー ターゲットでマルチサンプリングを実行する必要があります。 たとえば、埋め込みD3D11_TEXTURE2D_DESC構造体を使用して ID3D11Device::CreateTexture2D を呼び出してマルチサンプリング テクスチャを作成します (BindFlags メンバーはD3D11_BIND_RENDER_TARGETに設定され、SampleDesc メンバーはマルチサンプリング パラメーターを使用します)。 次 に ID3D11Device::CreateRenderTargetView を呼び出して、テクスチャのレンダー ターゲット ビューを作成し、シーンをテクスチャにレンダリングします。 最後に ID3D11DeviceContext::ResolveSubresource を呼び出して、マルチサンプリングされていないスワップ チェーンにマルチサンプリング テクスチャを解決します。

プレゼンテーション モデル間の主な違いは、コンポジションのためにバックバッファー コンテンツをデスクトップ ウィンドウ マネージャー (DWM) に取得する方法です。 DXGI_SWAP_EFFECT_DISCARD値とDXGI_SWAP_EFFECT_SEQUENTIAL値と共に使用される bitblt モデルでは、IDXGISwapChain1::P resent1 の呼び出しごとに、バック バッファーの内容がリダイレクト画面にコピーされます。 DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL値と共に使用されるフリップ モデルでは、すべてのバック バッファーが DWM と共有されます。 したがって、DWM は、追加のコピー操作を行わずに、それらのバック バッファーから直接作成できます。 一般に、フリップ モデルの方が効率的なモデルです。 フリップ モデルには、現在の統計の拡張など、より多くの機能も用意されています。

DXGI_SWAP_EFFECT_FLIP_SEQUENTIALとDXGI_SWAP_EFFECT_FLIP_DISCARDの違いは、DXGI_SWAP_EFFECT_FLIP_SEQUENTIALが DXGI に対して、各バック バッファーの内容が呼び出し間でIDXGISwapChain::Present保持されることを保証する必要があるのに対し、DXGI_SWAP_EFFECT_FLIP_DISCARDはこの保証を提供しないということです。 コンポジターは、特定のシナリオでは DirectFlip を使用できます。DirectFlip では、アプリケーションのバック バッファーをディスプレイ バック バッファー全体として使用します。これにより、アプリケーションのバック バッファーを最終的なデスクトップ バック バッファーにコピーするコストが削減されます。 DXGI_SWAP_EFFECT_FLIP_SEQUENTIALとDXGI_SWAP_EFFECT_FLIP_DISCARDでは、この最適化は、アプリケーションが画面に表示される唯一の項目である場合に発生する可能性があります。 ただし、画面に表示される項目がアプリケーション以外の場合でも、フリップ モデルが DXGI_SWAP_EFFECT_FLIP_DISCARD場合、コンポジターは、アプリケーションのバック バッファーに他のコンテンツを描画することで、この最適化を実行できます。

SyncInterval パラメーターで 0 が指定されたフリップ モデル スワップ チェーン (DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL) で IDXGISwapChain1::P resent1 を呼び出すと、IDXGISwapChain1::P resent1 の動作は、Direct3D 9Ex の IDirect3DDevice9Ex::P resentEx と同じであり、D3DSWAPEFFECT_FLIPEXとD3DPRESENT_FORCEIMMEDIATE。 つまり、ランタイムは、以前にキューに入れられていたフレームではなく、次のフレームを表示するだけでなく、以前にキューに入れたフレームに残っている残りの時間も終了します。

フリップ モデルの方が効率的かどうかに関係なく、GDI と DirectX プレゼンテーションを混在させる唯一の方法はビットレット モデルであるため、アプリケーションでビットレット モデルを選択できます。 フリップ モデルでは、アプリケーションは 、DXGI_SWAP_CHAIN_FLAG_GDI_COMPATIBLEを使用してスワップ チェーンを作成し、その後、バック バッファーで GetDC を明示的に使用する必要があります。 フリップ モデル スワップ チェーンで IDXGISwapChain1::P resent1 が最初に正常に呼び出された後、GDI は、スワップ チェーンの破棄後でも、そのスワップ チェーンに関連付けられている HWND で動作しなくなります。 この制限は、 ScrollWindowEx などのメソッドにも及びます。

フリップ モデル スワップ チェーンとプレゼンテーションの最適化の詳細については、「反転モデルを使用したプレゼンテーションの拡張」、「四角形のダーティ」、「スクロール領域」を参照してください。

例

UWP でスワップ チェーンを作成するには、DX11 テンプレートの新しいインスタンスを作成し、D3D12 サンプルの のDeviceResources::CreateWindowSizeDependentResources実装を確認するだけで済みます。

DXGI_SWAP_CHAIN_DESC1 swapChainDesc = {0};

       swapChainDesc.Width = lround(m_d3dRenderTargetSize.Width);    // Match the size of the window.
       swapChainDesc.Height = lround(m_d3dRenderTargetSize.Height);
       swapChainDesc.Format = DXGI_FORMAT_B8G8R8A8_UNORM;            // This is the most common swap chain format.
       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;                                // Use double-buffering to minimize latency.
       swapChainDesc.SwapEffect = DXGI_SWAP_EFFECT_FLIP_DISCARD;     // All Windows Store apps must use a flip effect.
       swapChainDesc.Flags = 2048;
       swapChainDesc.Scaling = scaling;
       swapChainDesc.AlphaMode = DXGI_ALPHA_MODE_IGNORE;

       // This sequence obtains the DXGI factory that was used to create the Direct3D device above.
       ComPtr<IDXGIDevice3> dxgiDevice;
       DX::ThrowIfFailed(m_d3dDevice.As(&dxgiDevice));

       ComPtr<IDXGIAdapter> dxgiAdapter;
       DX::ThrowIfFailed(dxgiDevice->GetAdapter(&dxgiAdapter));

       ComPtr<IDXGIFactory4> dxgiFactory;
       DX::ThrowIfFailed(dxgiAdapter->GetParent(IID_PPV_ARGS(&dxgiFactory)));

       ComPtr<IDXGISwapChain1> swapChain;
       DX::ThrowIfFailed(
              dxgiFactory->CreateSwapChainForCoreWindow(
                     m_d3dDevice.Get(),
                     reinterpret_cast<IUnknown*>(m_window.Get()),
                     &swapChainDesc,
                     nullptr,
                     &swapChain
                     )
              );

要件

こちらもご覧ください

DXGI 列挙

最適なパフォーマンスを得るための DXGI フリップ モデルを使用する