IDirect3DSwapChain9 interface (d3d9.h)

Applications use the methods of the IDirect3DSwapChain9 interface to manipulate a swap chain.

Inheritance

The IDirect3DSwapChain9 interface inherits from the IUnknown interface. IDirect3DSwapChain9 also has these types of members:

Methods

The IDirect3DSwapChain9 interface has these methods.

 
IDirect3DSwapChain9::GetBackBuffer

The IDirect3DSwapChain9::GetBackBuffer (d3d9.h) method retrieves a back buffer from the swap chain of the device.
IDirect3DSwapChain9::GetDevice

The IDirect3DSwapChain9::GetDevice (d3d9.h) method retrieves the device associated with the swap chain.
IDirect3DSwapChain9::GetDisplayMode

The IDirect3DSwapChain9::GetDisplayMode (d3d9.h) method retrieves the display mode's spatial resolution, color resolution, and refresh frequency.
IDirect3DSwapChain9::GetFrontBufferData

The IDirect3DSwapChain9::GetFrontBufferData (d3d9.h) method generates a copy of the swapchain's front buffer and places that copy in a system memory buffer.
IDirect3DSwapChain9::GetPresentParameters

The IDirect3DSwapChain9::GetPresentParameters (d3d9.h) method retrieves the presentation parameters associated with a swap chain.
IDirect3DSwapChain9::GetRasterStatus

The IDirect3DSwapChain9::GetRasterStatus (d3d9.h) method returns information describing the raster of the monitor on which the swap chain is presented.
IDirect3DSwapChain9::Present

The IDirect3DSwapChain9::Present (d3d9.h) method presents the contents of the next buffer in the sequence of back buffers owned by the swap chain.

Remarks

There is always at least one swap chain for each device, known as the implicit swap chain. However, an additional swap chain for rendering multiple views from the same device can be created by calling the IDirect3DDevice9::CreateAdditionalSwapChain method.

This interface, like all COM interfaces, inherits from the IUnknown interface.

The LPDIRECT3DSWAPCHAIN9 and PDIRECT3DSWAPCHAIN9 types are defined as pointers to the IDirect3DSwapChain9 interface.


typedef struct IDirect3DSwapChain9 *LPDIRECT3DSWAPCHAIN9, *PDIRECT3DSWAPCHAIN9;

Note the application should ensure that its associated device window is visible when its swapchain(s) is in fullscreen mode. Invisible windows cannot receive user mode events and invisible fullscreen windows will interfere with other windowed mode applications' presentation.

Requirements

Requirement Value
Target Platform Windows
Header d3d9.h (include D3D9.h)

See also

Direct3D Interfaces

IDirect3DDevice9::CreateAdditionalSwapChain