IDirect3DDevice8::CreateAdditionalSwapChain

This method creates an additional swap chain for rendering multiple views.

HRESULT CreateAdditionalSwapChain(
  D3DPRESENT_PARAMETERS* pPresentationParameters,
  IDirect3DSwapChain8** ppSwapChain
);

Parameters

• pPresentationParameters
  [in] Pointer to a D3DPRESENT_PARAMETERS structure, representing the presentation parameters for the new swap chain. This value cannot be NULL.
• ppSwapChain
  [out, retval] Address of a pointer to an IDirect3DSwapChain8 interface, representing the additional swap chain.

Return Values

If the method succeeds, the return value is D3D_OK.

If the method fails, the return value can be one of the following values:

• D3DERR_INVALIDCALL
• D3DERR_OUTOFVIDEOMEMORY
• E_OUTOFMEMORY

Remarks

There is always at least one swap chain (the implicit swap chain) for each device, because Microsoft® Direct3D® for Microsoft DirectX® 8.0 has one swap chain as a property of the device.

Note that any given device can support only one full-screen swap chain.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: D3d8.h.
Link Library: D3d8.lib.

See Also

Presenting Multiple Views in Windowed Mode | IDirect3DSwapChain8 | D3DPRESENT_PARAMETERS | IDirect3DDevice8

 Last updated on Thursday, April 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.