enumeración DXGI_SWAP_EFFECT (dxgi.h)

Opciones para controlar píxeles en una superficie de visualización después de llamar a 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
} ;

Constantes

Comentarios

Esta enumeración la usan las estructuras DXGI_SWAP_CHAIN_DESC y DXGI_SWAP_CHAIN_DESC1 .

En D3D12, solo se admiten DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL y DXGI_SWAP_EFFECT_FLIP_DISCARD , y los modelos bitblt no. Por este motivo, no se admite el muestreo múltiple de un búfer de reserva en D3D12 y debe realizar manualmente el muestreo múltiple en la aplicación mediante ID3D12GraphicsCommandList::ResolveSubresource o ID3D12GraphicsCommandList1::ResolveSubresourceRegion.

Para usar el muestreo múltiple con DXGI_SWAP_EFFECT_SEQUENTIAL o DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL, debe realizar el muestreo múltiple en un destino de representación independiente. Por ejemplo, cree una textura de muestreo múltiple llamando a ID3D11Device::CreateTexture2D con una estructura de D3D11_TEXTURE2D_DESC rellena (miembro BindFlags establecido en D3D11_BIND_RENDER_TARGET y miembro SampleDesc con parámetros de muestreo múltiple). A continuación, llame a ID3D11Device::CreateRenderTargetView para crear una vista de destino de representación para la textura y representar la escena en la textura. Por último, llame a ID3D11DeviceContext::ResolveSubresource para resolver la textura multimuestreo en la cadena de intercambio no multimuestreo.

La principal diferencia entre los modelos de presentación es cómo el contenido del búfer de reserva llega al Administrador de ventanas de escritorio (DWM) para la composición. En el modelo bitblt, que se usa con los valores de DXGI_SWAP_EFFECT_DISCARD y DXGI_SWAP_EFFECT_SEQUENTIAL , el contenido del búfer de reserva se copia en la superficie de redireccionamiento en cada llamada a IDXGISwapChain1::P resent1. En el modelo de volteo, que se usa con el valor de DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL , todos los búferes de reserva se comparten con DWM. Por lo tanto, DWM puede componer directamente desde esos búferes de reserva sin ninguna operación de copia adicional. En general, el modelo de volteo es el modelo más eficaz. El modelo de volteo también proporciona más características, como estadísticas presentes mejoradas.

La diferencia entre DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL y DXGI_SWAP_EFFECT_FLIP_DISCARD es que DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL obliga a DXGI a garantizar que el contenido de cada búfer de reserva se conserva entre IDXGISwapChain::Present llamadas, mientras que DXGI_SWAP_EFFECT_FLIP_DISCARD no proporciona esta garantía. El compositor, en ciertos escenarios, puede usar DirectFlip, donde usa el búfer de reserva de la aplicación como el búfer de reserva de la pantalla completa, que reduce el costo de copiar el búfer de reserva de la aplicación en el búfer back del escritorio final. Con DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL y DXGI_SWAP_EFFECT_FLIP_DISCARD, esta optimización puede producirse cuando la aplicación es el único elemento visible en la pantalla. Sin embargo, incluso cuando la aplicación no es el único elemento visible en la pantalla, si el modelo de volteo es DXGI_SWAP_EFFECT_FLIP_DISCARD, el compositor puede seguir realizando esta optimización, dibujando otro contenido en el búfer de reserva de la aplicación.

Al llamar a IDXGISwapChain1::P resent1 en una cadena de intercambio de modelos invertida (DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL) con 0 especificado en el parámetro SyncInterval, el comportamiento de IDXGISwapChain1::P resent1 es el mismo que el comportamiento de IDirect3D 9Ex de Direct3DDevice9Ex::P resentEx con D3DSWAPEFFECT_FLIPEX y D3DPRESENT_FORCEIMMEDIATE. Es decir, el tiempo de ejecución no solo presenta el siguiente fotograma en lugar de los fotogramas en cola anteriores, también finaliza el tiempo restante que queda en los fotogramas en cola anteriormente.

Independientemente de si el modelo de volteo es más eficaz, una aplicación todavía podría elegir el modelo bitblt porque el modelo bitblt es la única manera de mezclar la presentación GDI y DirectX. En el modelo de volteo, la aplicación debe crear la cadena de intercambio con DXGI_SWAP_CHAIN_FLAG_GDI_COMPATIBLE y, a continuación, debe usar GetDC en el búfer de reserva explícitamente. Después de la primera llamada correcta a IDXGISwapChain1::P resent1 en una cadena de intercambio de modelo invertida, GDI ya no funciona con el HWND asociado a esa cadena de intercambio, incluso después de la destrucción de la cadena de intercambio. Esta restricción se extiende incluso a métodos como ScrollWindowEx.

Para obtener más información sobre la cadena de intercambio de modelos invertidos y la optimización de la presentación, consulta Mejorar la presentación con el modelo de volteo, rectángulos sucios y áreas desplazadas.

Ejemplos

Para crear una cadena de intercambio en UWP, solo tienes que crear una nueva instancia de la plantilla DX11 y ver la implementación de en los ejemplos de DeviceResources::CreateWindowSizeDependentResourcesD3D12.

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

Requisitos

Consulte también

DxGI (enumeraciones)

Para obtener el mejor rendimiento, use el modelo de volteo DXGI.