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

  • Artigo

Gera uma cópia do buffer frontal do dispositivo e coloca essa cópia em um buffer de memória do sistema fornecido pelo aplicativo.

Sintaxe

HRESULT GetFrontBufferData(
  [in] UINT              iSwapChain,
  [in] IDirect3DSurface9 *pDestSurface
);

Parâmetros

[in] iSwapChain

Tipo: UINT

Um inteiro sem sinal que especifica a cadeia de troca.

[in] pDestSurface

Tipo: IDirect3DSurface9*

Ponteiro para uma interface IDirect3DSurface9 que receberá uma cópia do conteúdo do buffer frontal. Os dados são retornados em linhas sucessivas sem espaço de intervenção, começando da linha verticalmente mais alta na saída do dispositivo 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 o método falhar, o valor retornado poderá ser um dos seguintes: D3DERR_DRIVERINTERNALERROR, D3DERR_DEVICELOST D3DERR_INVALIDCALL

Comentários

O buffer apontado por pDestSurface será preenchido com uma representação do buffer frontal, convertido no formato padrão de 32 bits por pixel D3DFMT_A8R8G8B8.

Esse método é a única maneira de capturar uma captura de tela suavizada.

Essa função é muito lenta, por design, e não deve ser usada em nenhum caminho crítico de desempenho.

Para obter mais informações, consulte Dispositivos perdidos e dados recuperados.

Requisitos

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

Confira também

IDirect3DDevice9