Método IDirect3DDevice9::GetBackBuffer (d3d9.h)

Recupera um buffer traseiro da cadeia de troca do dispositivo.

Sintaxe

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

Parâmetros

[in] iSwapChain

Tipo: UINT

Um inteiro sem sinal que especifica a cadeia de troca.

[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 menos um. 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 IDirect3DDevice9::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.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, o valor retornado será D3D_OK. Se BackBuffer for igual ou exceder o 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.

Requisitos

Confira também

IDirect3DDevice9

IDirect3DDevice9::GetFrontBufferData