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 |