Share via

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

  • Artigo

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

Confira também

IDirect3DSwapChain9