Método IDirect3DDevice9::GetRenderTargetData (d3d9helper.h)
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 |