IDirect3DDevice9::GetRenderTargetData 方法 (d3d9helper.h)

将呈现器目标数据从设备内存复制到系统内存。

语法

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

参数

[in] pRenderTarget

类型: IDirect3DSurface9*

指向表示呈现目标的 IDirect3DSurface9 对象的指针。

[in] pDestSurface

类型: IDirect3DSurface9*

指向表示目标图面 的 IDirect3DSurface9 对象的指针。

返回值

类型: HRESULT

如果该方法成功,则返回值D3D_OK。 如果方法失败,则返回值可以是下列值之一:D3DERR_DRIVERINTERNALERROR、D3DERR_DEVICELOST、D3DERR_INVALIDCALL。

注解

目标图面必须是屏幕外普通表面,或者是使用 D3DPOOL_SYSTEMMEM 创建的纹理 (mipmap 或立方体纹理) 级别。

源图面必须是常规呈现目标,或者是使用 POOL_DEFAULT 创建的 mipmap 或立方体纹理) (mipmap 或立方体纹理的级别。

如果以下问题,此方法将失败:

  • 呈现器目标为多重采样。
  • 源呈现目标的大小与目标图面不同。
  • 源呈现目标和目标图面格式不匹配。

要求

要求
目标平台 Windows
标头 d3d9helper.h (包括 D3D9.h)
Library D3D9.lib

另请参阅

IDirect3DDevice9