CreateSurfacePresenter method

Returns an ISurfacePresenter interface with an DXGI buffer chain.

Syntax

HRESULT retVal = object.CreateSurfacePresenter(pDevice, width, height, backBufferCount, format, mode, ppQueue);

Parameters

• pDevice [in]
  Type: IUnknown

  The device to be used. Pass NULL if hardware acceleration is not being used in mshtml.

• width [in]
  Type: UINT

  The width of the front buffer. This also dictates the size of back buffers.

• height [in]
  Type: UINT

  The height of the front buffer. This also dictates the size of back buffers.

• backBufferCount [in]
  Type: UINT

  The number of back buffers to create.

• format [in]
  Type: DXGI_FORMAT

  The DXGI render format. Internet Explorer 9 currently only supports DXGI_FORMAT_B8G8R8A8_UNORM.

• mode [in]
  Type: VIEW_OBJECT_ALPHA_MODE

  Indicates how to interpret the alpha channel of the buffer.

• ppQueue [out, retval]
  Type: ISurfacePresenter

  An ISurfacePresenter interface.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

pDevice must be a valid IDirect3DDevice9Ex, ID3D10Device, or ID3D11Device. If pDevice is NULL, it creates a chain of Windows Imaging Component (WIC) bitmap buffers rather than hardware accelerated buffers.