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

  • Artículo

Copia los datos de destino de representación de la memoria del dispositivo en la memoria del sistema.

Sintaxis

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

Parámetros

[in] pRenderTarget

Tipo: IDirect3DSurface9*

Puntero a un objeto IDirect3DSurface9 que representa un destino de representación.

[in] pDestSurface

Tipo: IDirect3DSurface9*

Puntero a un objeto IDirect3DSurface9 , que representa una superficie de destino.

Valor devuelto

Tipo: HRESULT

Si el método se ejecuta correctamente, el valor devuelto es D3D_OK. Si se produce un error en el método, el valor devuelto puede ser uno de los siguientes: D3DERR_DRIVERINTERNALERROR, D3DERR_DEVICELOST, D3DERR_INVALIDCALL.

Comentarios

La superficie de destino debe ser una superficie sin formato fuera de la pantalla o un nivel de textura (mapa mip o textura de cubo) creada con D3DPOOL_SYSTEMMEM.

La superficie de origen debe ser un destino de representación normal o un nivel de una textura de destino de representación (textura de mapa mip o cubo) creada con POOL_DEFAULT.

Este método producirá un error si:

  • El destino de representación es multimuestreo.
  • El destino de representación de origen es un tamaño diferente al de la superficie de destino.
  • Los formatos de la superficie de destino y destino de representación de origen no coinciden.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado d3d9helper.h (incluya D3D9.h)
Library D3D9.lib

Consulte también

IDirect3DDevice9