IDirect3DSwapChain9 interface (d3d9helper.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 method (d3d9helper.h) retrieves a back buffer from the swap chain of the device. |
| IDirect3DSwapChain9::GetDevice The IDirect3DSwapChain9::GetDevice method (d3d9helper.h) retrieves the device associated with the swap chain. |
| IDirect3DSwapChain9::GetDisplayMode The IDirect3DSwapChain9::GetDisplayMode method (d3d9helper.h) retrieves the display mode's spatial resolution, color resolution, and refresh frequency. |
| IDirect3DSwapChain9::GetFrontBufferData The IDirect3DSwapChain9::GetFrontBufferData method (d3d9helper.h) generates a copy of the swapchain's front buffer and places that copy in a system memory buffer provided by the application. |
| IDirect3DSwapChain9::GetPresentParameters The IDirect3DSwapChain9::GetPresentParameters method (d3d9helper.h) retrieves the presentation parameters associated with a swap chain. |
| IDirect3DSwapChain9::GetRasterStatus The IDirect3DSwapChain9::GetRasterStatus method (d3d9helper.h) returns information describing the raster of the monitor on which the swap chain is presented. |
| IDirect3DSwapChain9::Present The IDirect3DSwapChain9::Present method (d3d9helper.h) 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 | d3d9helper.h (include D3D9.h) |