enumerazione DXGI_SWAP_EFFECT (dxgi.h)

Opzioni per la gestione dei pixel in un'area di visualizzazione dopo aver chiamato IDXGISwapChain1::P resent1.

Sintassi

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

Costanti

Commenti

Questa enumerazione viene usata dalle strutture DXGI_SWAP_CHAIN_DESC e DXGI_SWAP_CHAIN_DESC1 .

In D3D12 sono supportati solo DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL e DXGI_SWAP_EFFECT_FLIP_DISCARD e i modelli bitblt non sono supportati. A causa di questo, la multicampionamento di un buffer back non è supportata in D3D12 e è necessario eseguire manualmente l'esecuzione di multicampion nell'app usando ID3D12GraphicsCommandList::ResolveSubresource o ID3D12GraphicsCommandList1::ResolveSubresourceRegion.

Per usare la multicampionamento con DXGI_SWAP_EFFECT_SEQUENTIAL o DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL, è necessario eseguire il multicampionamento in una destinazione di rendering separata. Ad esempio, creare una trama multiampled chiamando ID3D11Device::CreateTexture2D con una struttura di D3D11_TEXTURE2D_DESC riempita (membro BindFlags impostato su D3D11_BIND_RENDER_TARGET e membro SampleDesc con parametri multicampionamento). Chiamare quindi ID3D11Device::CreateRenderTargetView per creare una visualizzazione di destinazione di rendering per la trama e eseguire il rendering della scena nella trama. Infine chiamare ID3D11DeviceContext::ResolveSubresource per risolvere la trama multisampled nella catena di scambio non multisampled.

La differenza principale tra i modelli di presentazione è il modo in cui il contenuto del buffer di back-buffer viene restituito a Desktop Window Manager (DWM) per la composizione. Nel modello bitblt, usato con i valori DXGI_SWAP_EFFECT_DISCARD e DXGI_SWAP_EFFECT_SEQUENTIAL , il contenuto del buffer indietro viene copiato nell'area di reindirizzamento in ogni chiamata a IDXGISwapChain1::P resent1. Nel modello di capovolgimento, usato con il valore DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL , tutti i buffer back vengono condivisi con DWM. Pertanto, DWM può comporre direttamente da tali buffer indietro senza alcuna operazione di copia aggiuntiva. In generale, il modello flip è il modello più efficiente. Il modello di capovolgimento offre anche altre funzionalità, ad esempio statistiche avanzate presenti.

La differenza tra DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL e DXGI_SWAP_EFFECT_FLIP_DISCARD è che DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL forza DXGI a garantire che il contenuto di ogni buffer back venga mantenuto tra IDXGISwapChain::Present chiamate, mentreDXGI_SWAP_EFFECT_FLIP_DISCARD non fornisce questa garanzia. Il compositore, in determinati scenari, può usare DirectFlip, in cui usa il buffer indietro dell'applicazione come intero buffer back di visualizzazione, che elide il costo della copia del buffer back dell'applicazione nel buffer back del desktop finale. Con DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL e DXGI_SWAP_EFFECT_FLIP_DISCARD, questa ottimizzazione può verificarsi quando l'applicazione è l'unico elemento visibile sullo schermo. Tuttavia, anche quando l'applicazione non è l'unico elemento visibile sullo schermo, se il modello di capovolgimento è DXGI_SWAP_EFFECT_FLIP_DISCARD, il compositore può comunque eseguire questa ottimizzazione, disegnando altri contenuti nel buffer indietro dell'applicazione.

Quando si chiama IDXGISwapChain1::P resent1 in una catena di scambio di modelli capovolgimento (DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL) con 0 specificati nel parametro SyncInterval , IDXGISwapChain1::P resent1 è lo stesso comportamento di IDirect3D 9Ex'sIDirect3DDevice9Ex::P resentEx con D3DSWAPEFFECT_FLIPEXe D3DPRESENT_FORCEIMMEDIATE. Ovvero, il runtime non solo presenta il frame successivo anziché qualsiasi frame precedentemente accodato, termina anche qualsiasi tempo rimanente lasciato nei fotogrammi in coda precedentemente.

Indipendentemente dal fatto che il modello flip sia più efficiente, un'applicazione potrebbe comunque scegliere il modello bitblt perché il modello bitblt è l'unico modo per combinare la presentazione GDI e DirectX. Nel modello di scorrimento, l'applicazione deve creare la catena di scambio con DXGI_SWAP_CHAIN_FLAG_GDI_COMPATIBLE e quindi deve usare GetDC nel buffer indietro in modo esplicito. Dopo la prima chiamata riuscita a IDXGISwapChain1::P resent1 in una catena di scambio di modelli flip, GDI non funziona più con il HWND associato a tale catena di scambio, anche dopo la distruzione della catena di scambio. Questa restrizione si estende anche ai metodi come ScrollWindowEx.

Per altre informazioni sulla catena di scambio del modello capovolgimento e sull'ottimizzazione della presentazione, vedere Miglioramento della presentazione con il modello di capovolgimento, i rettangoli sporchi e le aree a scorrimento.

Esempio

Per creare una catena di scambio in UWP, è sufficiente creare una nuova istanza del modello DX11 e esaminare l'implementazione di DeviceResources::CreateWindowSizeDependentResources negli esempi D3D12.

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

Requisiti

Vedi anche

Enumerazioni DXGI

Per prestazioni ottimali, usare il modello flip DXGI