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 |