DXGI_SWAP_EFFECT列挙 (dxgi.h)

[アーティクル]
02/22/2025

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_EFFECT_DISCARD` 値: 0 このフラグを使用して、ビットブロック転送 (bitblt) モデルを指定し、IDXGISwapChain1::P resent1 呼び出した後に DXGI がバックバッファーの内容を破棄するように指定します。このフラグは、複数のバックバッファーを持つスワップチェーンに対して有効ですが、アプリケーションはバッファー 0 への読み取りおよび書き込みアクセス権のみを持ちます。このフラグを使用して、ディスプレイドライバーがスワップチェーンの最も効率的なプレゼンテーション手法を選択できるようにします。 Direct3D 12: この列挙値はサポートされていません。 D3D12 アプリでは、DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL または DXGI_SWAP_EFFECT_FLIP_DISCARDを使用する必要があります。注全画面表示の排他的な UWP と全画面表示の UWP には違いがあります。 Windows PC 上の UWP に Direct3D 11 アプリケーションを移植する場合は、スワップチェーンを作成するときに DXGI_SWAP_EFFECT_DISCARD を使用することに注意してください。 UWP では Win32 と同じように動作しません。また、その使用は GPU のパフォーマンスに悪影響を与える可能性があります。これは、UWP アプリケーションが (他のスワップモードが設定されている場合でも) FLIP スワップモードに強制されるためです。以前の bitblt モデルによって最初に実行されたメモリコピーによって使用される時間。 DX11 破棄スワップチェーンを手動で変換し、可能な場合は DXGI_SWAP_EFFECT_DISCARD の代わりに DXGI_SWAP_EFFECT_FLIP_DISCARD を使用して、UWP 内でフリップモデルを使用することをお勧めします。詳細については、以下の例を参照し、この記事参照してください。
`DXGI_SWAP_EFFECT_SEQUENTIAL` 値: 1 このフラグを使用して、bitblt モデルを指定し、IDXGISwapChain1::P resent1 呼び出した後に DXGI がバックバッファーの内容を保持するように指定します。最初のバッファー (バッファー 0) から最後のバッファーまで、スワップチェーンの内容を順番に表示するには、このオプションを使用します。このフラグはマルチサンプリングでは使用できません。 Direct3D 12: この列挙値はサポートされていません。 D3D12 アプリでは、DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL または DXGI_SWAP_EFFECT_FLIP_DISCARDを使用する必要があります。パフォーマンスを最大限に高めるには、DXGI_SWAP_EFFECT_SEQUENTIALではなく DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL を使用してください。詳細については、この記事参照してください。
`DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL` 値: 3 このフラグを使用して、フリッププレゼンテーションモデルを指定し、IDXGISwapChain1::P resent1 呼び出した後に DXGI がバックバッファーの内容を保持するように指定します。このフラグはマルチサンプリングでは使用できません。 Direct3D 11: この列挙値は、Windows 8 以降でサポートされています。
`DXGI_SWAP_EFFECT_FLIP_DISCARD` 値: 4 このフラグを使用して、フリッププレゼンテーションモデルを指定し、IDXGISwapChain1::P resent1 呼び出した後に DXGI がバックバッファーの内容を破棄するように指定します。このフラグは、マルチサンプリングおよび部分プレゼンテーションでは使用できません。 DXGI 1.4 のを参照してください。 Direct3D 11: この列挙値は、Windows 10 以降でサポートされています。このフラグは、複数のバックバッファーを持つスワップチェーンに対して有効です。ただし、アプリケーションはバッファー 0 に対してのみ読み取りと書き込みアクセスを行います。 Windows ストアアプリDXGI_SWAP_EFFECT_FLIP_SEQUENTIAL または DXGI_SWAP_EFFECT_FLIP_DISCARDを使用する必要があることに注意してください。

備考

この列挙体は、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 構造体 (BindFlags メンバーを D3D11_BIND_RENDER_TARGET に設定し、マルチサンプリングパラメーターを持つ SampleDesc メンバーを) ID3D11Device::CreateTexture2D を呼び出して、マルチサンプリングテクスチャを作成します。次 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、各バックバッファーの内容が IDXGISwapChain::Present 呼び出し間で保持されることを DXGI に強制するのに対し、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's IDirect3DDevice9Ex::P resentEx D3DSWAPEFFECT_FLIPEX および D3DPRESENT_FORCEIMMEDIATEの動作と同じです。つまり、ランタイムは、以前にキューに入れられていたフレームの代わりに次のフレームを提示するだけでなく、以前にキューに入れたフレームに残っている残りの時間も終了します。

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

HDR スワップチェーンバッファー形式と色空間を表示するには、フリップモデルが必要です。それ以外の場合は、SDR (0 ~ 1 の範囲の sRGB) で構成 (およびクリップ) されます。

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

例

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.h

次の方法で共有

DXGI_SWAP_EFFECT列挙 (dxgi.h)

構文

定数

備考

例

必要条件

関連項目

フィードバック

その他のリソース