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](ff976290(v=vs.85).md)

    Indicates how to interpret the alpha channel of the buffer.

  • ppQueue [out, retval]
    Type: [ISurfacePresenter](ff975137(v=vs.85).md)

    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.