Método IDirect3DSwapChain9::GetFrontBufferData (d3d9helper.h)
Gera uma cópia do buffer frontal da cadeia de troca e coloca que copiam em um buffer de memória do sistema fornecido pelo aplicativo.
Sintaxe
HRESULT GetFrontBufferData(
[in, out] IDirect3DSurface9 *pDestSurface
);
Parâmetros
[in, out] pDestSurface
Tipo: IDirect3DSurface9*
Ponteiro para uma interface IDirect3DSurface9 que receberá uma cópia do buffer frontal do swapchain. Os dados são retornados em linhas sucessivas sem espaço intervindo, começando da linha verticalmente mais alta para a mais baixa. Para o modo em janelas, o tamanho da superfície de destino deve ser do tamanho da área de trabalho. Para o modo de tela inteira, o tamanho da superfície de destino deve ser o tamanho da tela.
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.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | d3d9helper.h (inclua D3D9.h) |
| Biblioteca | D3D9.lib |