IDXGISwapChain1 interface

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

Members

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

Methods

The IDXGISwapChain1 interface has these methods.

MethodDescription
GetBackgroundColor

Retrieves the background color of the swap chain.

GetCoreWindow

Retrieves the underlying CoreWindow object for this swap-chain object.

GetDesc1

Gets a description of the swap chain.

GetFullscreenDesc

Gets a description of a full-screen swap chain.

GetHwnd

Retrieves the underlying HWND for this swap-chain object.

GetRestrictToOutput

Gets the output (the display monitor) to which you can restrict the contents of a present operation.

GetRotation

Gets the rotation of the back buffers for the swap chain.

IsTemporaryMonoSupported

Determines whether a swap chain supports “temporary mono.”

Present1

Presents a frame on the display screen.

SetBackgroundColor

Changes the background color of the swap chain.

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.

Windows Phone 8: This API is supported.

Requirements

Minimum supported client

Windows 8 and Platform Update for Windows 7 [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2012 and Platform Update for Windows Server 2008 R2 [desktop apps | Windows Store apps]

Header

DXGI1_2.h

Library

Dxgi.lib

See also

IDXGIFactory2::CreateSwapChainForHwnd
IDXGIFactory2::CreateSwapChainForCoreWindow
IDXGIFactory2::CreateSwapChainForComposition

 

 

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.