IDXGISwapChain1 interface (dxgi1_2.h)

Provides presentation capabilities that are enhanced from IDXGISwapChain. These presentation capabilities consist of specifying dirty rectangles and scroll rectangle to optimize the presentation.

Inheritance

The IDXGISwapChain1 interface inherits from IDXGISwapChain. IDXGISwapChain1 also has these types of members:

Methods

The IDXGISwapChain1 interface has these methods.

IDXGISwapChain1::GetBackgroundColor Retrieves the background color of the swap chain.
IDXGISwapChain1::GetCoreWindow Retrieves the underlying CoreWindow object for this swap-chain object.
IDXGISwapChain1::GetDesc1 Gets a description of the swap chain.
IDXGISwapChain1::GetFullscreenDesc Gets a description of a full-screen swap chain.
IDXGISwapChain1::GetHwnd Retrieves the underlying HWND for this swap-chain object.
IDXGISwapChain1::GetRestrictToOutput Gets the output (the display monitor) to which you can restrict the contents of a present operation.
IDXGISwapChain1::GetRotation Gets the rotation of the back buffers for the swap chain.
IDXGISwapChain1::IsTemporaryMonoSupported Determines whether a swap chain supports “temporary mono.”
IDXGISwapChain1::Present1 Presents a frame on the display screen.
IDXGISwapChain1::SetBackgroundColor Changes the background color of the swap chain.
IDXGISwapChain1::SetRotation Sets the rotation of the back buffers for the swap chain.

Remarks

You can create a swap chain by calling IDXGIFactory2::CreateSwapChainForHwnd, IDXGIFactory2::CreateSwapChainForCoreWindow, or IDXGIFactory2::CreateSwapChainForComposition. You can also create a swap chain when you call D3D11CreateDeviceAndSwapChain; however, you can then only access the sub-set of swap-chain functionality that the IDXGISwapChain interface provides.

IDXGISwapChain1 provides the IsTemporaryMonoSupported method that you can use to determine whether the swap chain supports "temporary mono” presentation. This type of swap chain is a stereo swap chain that can be used to present mono content.

Note  Some stereo features like the advanced presentation flags are not represented by an explicit interface change. Furthermore, the original (IDXGISwapChain) and new (IDXGISwapChain1) swap chain interfaces generally have the same behavior. For information about how IDXGISwapChain methods are translated into IDXGISwapChain1 methods, see the descriptions of the IDXGISwapChain1 methods.

 

Requirements

Requirement	Value
Minimum supported client	Windows 8 and Platform Update for Windows 7 [desktop apps | UWP apps]
Minimum supported server	Windows Server 2012 and Platform Update for Windows Server 2008 R2 [desktop apps | UWP apps]
Target Platform	Windows
Header	dxgi1_2.h

See also

DXGI Interfaces

IDXGIFactory2::CreateSwapChainForComposition

IDXGIFactory2::CreateSwapChainForCoreWindow

IDXGIFactory2::CreateSwapChainForHwnd

IDXGISwapChain