Compartilhar via


Método IDirect3DSwapChain9::GetBackBuffer (d3d9helper.h)

Recupera um buffer traseiro da cadeia de troca do dispositivo.

Sintaxe

HRESULT GetBackBuffer(
  [in]          UINT               iBackBuffer,
  [in]          D3DBACKBUFFER_TYPE Type,
  [out, retval] IDirect3DSurface9  **ppBackBuffer
);

Parâmetros

[in] iBackBuffer

Tipo: UINT

Índice do objeto de buffer traseiro a ser retornado. Os buffers traseiros são numerados de 0 para o número total de buffers traseiros – 1. Um valor 0 retorna o primeiro buffer traseiro, não o buffer frontal. O buffer frontal não está acessível por meio desse método. Use IDirect3DSwapChain9::GetFrontBufferData para recuperar uma cópia do buffer frontal.

[in] Type

Tipo: D3DBACKBUFFER_TYPE

Não há suporte para a exibição estéreo no Direct3D 9, portanto, o único valor válido para esse parâmetro é D3DBACKBUFFER_TYPE_MONO.

[out, retval] ppBackBuffer

Tipo: IDirect3DSurface9**

Endereço de um ponteiro para uma interface IDirect3DSurface9 , representando a superfície de buffer voltar retornada.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, o valor retornado será D3D_OK. Se BackBuffer exceder ou for igual ao número total de buffers traseiros, a função falhará e retornará D3DERR_INVALIDCALL.

Comentários

Chamar esse método aumentará a contagem de referência interna na interface IDirect3DSurface9 . Falha ao chamar IUnknown::Release quando terminar de usar essa interface IDirect3DSurface9 resulta em um vazamento de memória. Você deve liberar todas as superfícies obtidas por meio desse método antes de liberar a cadeia de troca à qual ela pertence.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho d3d9helper.h (inclua D3D9.h)
Biblioteca D3D9.lib

Confira também

IDirect3DSwapChain9

IDirect3DSwapChain9::GetFrontBufferData