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