IDirect3DDevice8::CreateAdditionalSwapChain

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.

Remarks

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

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

Requirements

  Header: Declared in D3d8.h.
  Import Library: Use D3d8.lib.

See Also

Presenting Multiple Views in Windowed Mode