Compartilhar via


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

Recupera uma superfície de destino de renderização.

Sintaxe

HRESULT GetRenderTarget(
  [in]  DWORD             RenderTargetIndex,
  [out] IDirect3DSurface9 **ppRenderTarget
);

Parâmetros

[in] RenderTargetIndex

Tipo: DWORD

Índice do destino de renderização. Consulte Observações.

[out] ppRenderTarget

Tipo: IDirect3DSurface9**

Endereço de um ponteiro para uma interface IDirect3DSurface9 , representando a superfície de destino de renderização retornada para este dispositivo.

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 D3DERR_INVALIDCALL se um dos argumentos for inválido ou D3DERR_NOTFOUND se não houver nenhum destino de renderização disponível para o índice fornecido.

Comentários

Normalmente, os métodos que retornam o estado não funcionarão em um dispositivo criado usando D3DCREATE_PUREDEVICE. No entanto, esse método funcionará mesmo em um dispositivo puro porque ele retorna uma interface.

O dispositivo agora pode dar suporte a vários destinos de renderização. O número de destinos de renderização com suporte por um dispositivo está contido no membro NumSimultaneousRTs de D3DCAPS9. Consulte Vários destinos de renderização (Direct3D 9).

Chamar esse método aumentará a contagem de referência interna na interface IDirect3DSurface9 . Falha ao chamar IUnknown::Release quando terminar de usar a 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

IDirect3DDevice9

IDirect3DDevice9::SetRenderTarget