Método IDirect3DDevice9::GetRenderTargetData (d3d9helper.h)

  • Artigo

Copia os dados de destino de renderização da memória do dispositivo para a memória do sistema.

Sintaxe

HRESULT GetRenderTargetData(
  [in] IDirect3DSurface9 *pRenderTarget,
  [in] IDirect3DSurface9 *pDestSurface
);

Parâmetros

[in] pRenderTarget

Tipo: IDirect3DSurface9*

Ponteiro para um objeto IDirect3DSurface9 , representando um destino de renderização.

[in] pDestSurface

Tipo: IDirect3DSurface9*

Ponteiro para um objeto IDirect3DSurface9 , representando uma superfície de destino.

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

A superfície de destino deve ser uma superfície simples fora da tela ou um nível de textura (mipmap ou textura de cubo) criado com D3DPOOL_SYSTEMMEM.

A superfície de origem deve ser um destino de renderização regular ou um nível de uma textura de destino de renderização (mipmap ou textura de cubo) criada com POOL_DEFAULT.

Esse método falhará se:

  • O destino de renderização é multisampled.
  • O destino de renderização de origem é um tamanho diferente da superfície de destino.
  • Os formatos de destino de renderização de origem e superfície de destino não correspondem.

Requisitos

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

Confira também

IDirect3DDevice9