IDirect3DDevice9::GetRenderTargetData 方法 (d3d9.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 |
标头 | d3d9.h (包括 D3D9.h) |
Library | D3D9.lib |