DXGI_SWAP_EFFECT-Enumeration (dxgi.h)

Optionen für die Behandlung von Pixeln in einer Anzeigeoberfläche nach dem Aufruf von IDXGISwapChain1::P resent1.

Syntax

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
} ;

Konstanten

Hinweise

Diese Enumeration wird von den strukturen DXGI_SWAP_CHAIN_DESC und DXGI_SWAP_CHAIN_DESC1 verwendet.

In D3D12 werden nur DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL und DXGI_SWAP_EFFECT_FLIP_DISCARD unterstützt, die Bitblt-Modelle nicht. Aus diesem Grund wird multisampling a back buffer in D3D12 nicht unterstützt. Sie müssen multisampling in der App manuell mithilfe von ID3D12GraphicsCommandList::ResolveSubresource oder ID3D12GraphicsCommandList1::ResolveSubresourceRegion ausführen.

Um Multisampling mit DXGI_SWAP_EFFECT_SEQUENTIAL oder DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL zu verwenden, müssen Sie das Multisampling in einem separaten Renderziel ausführen. Erstellen Sie beispielsweise eine mehrstufige Textur, indem Sie ID3D11Device::CreateTexture2D mit einer gefüllten D3D11_TEXTURE2D_DESC-Struktur aufrufen (BindFlags-Member ist auf D3D11_BIND_RENDER_TARGET und SampleDesc-Member mit Multisampling-Parametern festgelegt). Rufen Sie als Nächstes ID3D11Device::CreateRenderTargetView auf, um eine Renderzielansicht für die Textur zu erstellen, und rendern Sie Ihre Szene in der Textur. Rufen Sie schließlich ID3D11DeviceContext::ResolveSubresource auf, um die mehrstufige Textur in Ihre Nicht-Multisampled-Swapkette aufzulösen.

Der Hauptunterschied zwischen Präsentationsmodellen besteht darin, wie Backpufferinhalte zum Desktopfenster-Manager (DWM) für die Komposition gelangen. Im Bitblt-Modell, das mit den Werten DXGI_SWAP_EFFECT_DISCARD und DXGI_SWAP_EFFECT_SEQUENTIAL verwendet wird, wird der Inhalt des Rückpuffers bei jedem Aufruf von IDXGISwapChain1::P resent1 in die Umleitungsoberfläche kopiert. Im Flip-Modell, das mit dem wert DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL verwendet wird, werden alle Backpuffer für den DWM freigegeben. Daher kann der DWM direkt aus diesen Backpuffern ohne zusätzliche Kopiervorgänge erstellen. Im Allgemeinen ist das Flip-Modell das effizientere Modell. Das Flip-Modell bietet auch weitere Features, z. B. erweiterte Gegenwartsstatistiken.

Der Unterschied zwischen DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL und DXGI_SWAP_EFFECT_FLIP_DISCARD besteht darin, dass DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL DXGI zwingt, sicherzustellen, dass der Inhalt der einzelnen Backpuffer über Aufrufe hinweg IDXGISwapChain::Present beibehalten wird, während DXGI_SWAP_EFFECT_FLIP_DISCARD diese Garantie nicht bietet. Der Compositor kann in bestimmten Szenarien DirectFlip verwenden, wobei er den Rückpuffer der Anwendung als gesamten Displaybackpuffer verwendet, was die Kosten für das Kopieren des Rückpuffers der Anwendung in den endgültigen Desktopbackpuffer verursacht. Mit DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL und DXGI_SWAP_EFFECT_FLIP_DISCARD kann diese Optimierung erfolgen, wenn die Anwendung das einzige auf dem Bildschirm sichtbare Element ist. Auch wenn die Anwendung nicht das einzige sichtbare Element auf dem Bildschirm DXGI_SWAP_EFFECT_FLIP_DISCARD ist, kann der Compositor in einigen Szenarien diese Optimierung dennoch durchführen, indem er andere Inhalte in den Rückpuffer der Anwendung zeichnet.

Wenn Sie IDXGISwapChain1::P resent1 in einer Flip Model Swap Chain (DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL) mit 0 aufrufen, die im SyncInterval-Parameter angegeben ist, entspricht das Verhalten von IDXGISwapChain1::P resent1 dem Verhalten von Direct3D 9ExIDirect3DDevice9Ex::P resentEx mit D3DSWAPEFFECT_FLIPEX und D3DPRESENT_FORCEIMMEDIATE. Das heißt, die Runtime stellt nicht nur den nächsten Frame anstelle von zuvor in die Warteschlange stehenden Frames dar, sondern beendet auch die verbleibende Zeit für die zuvor in die Warteschlange eingereihten Frames.

Unabhängig davon, ob das Flipmodell effizienter ist, kann eine Anwendung dennoch das Bitblt-Modell auswählen, da das Bitblt-Modell die einzige Möglichkeit ist, GDI- und DirectX-Präsentation zu kombinieren. Im Flip-Modell muss die Anwendung die Swapchain mit DXGI_SWAP_CHAIN_FLAG_GDI_COMPATIBLE erstellen und dann GetDC explizit auf dem Backpuffer verwenden. Nach dem ersten erfolgreichen Aufruf von IDXGISwapChain1::P resent1 in einer Flip-Model-Swapchain funktioniert GDI nicht mehr mit der HWND , die dieser Swap chain zugeordnet ist, auch nach der Zerstörung der Swap chain. Diese Einschränkung erstreckt sich sogar auf Methoden wie ScrollWindowEx.

Weitere Informationen zur Flipmodell-Swapchain und zur Optimierung der Präsentation finden Sie unter Verbessern der Präsentation mit dem Flip-Modell, modifiziert Rechtecke und scrollte Bereiche.

Beispiele

Um eine Swapchain in UWP zu erstellen, müssen Sie lediglich eine neue instance der DX11-Vorlage erstellen und sich die Implementierung von DeviceResources::CreateWindowSizeDependentResources in den D3D12-Beispielen ansehen.

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
                     )
              );

Anforderungen

Weitere Informationen

DXGI-Enumerationen

Verwenden Sie das DXGI-Flipmodell, um eine optimale Leistung zu erzielen.