IDirect3DDevice9：：GetRenderTarget 方法 (d3d9helper.h)

  • 项目

检索呈现目标图面。

语法

HRESULT GetRenderTarget(
  [in]  DWORD             RenderTargetIndex,
  [out] IDirect3DSurface9 **ppRenderTarget
);

参数

[in] RenderTargetIndex

类型： DWORD

呈现器目标的索引。 请参阅“备注”。

[out] ppRenderTarget

类型： IDirect3DSurface9**

指向 IDirect3DSurface9 接口的指针的地址，表示此设备返回的呈现目标图面。

返回值

类型： HRESULT

如果方法成功，则返回值D3D_OK。 如果 方法失败，则如果其中一个参数无效，则可以D3DERR_INVALIDCALL返回值;如果没有可用于给定索引的呈现目标，则可以D3DERR_NOTFOUND返回值。

注解

通常，返回状态的方法在使用 D3DCREATE_PUREDEVICE 创建的设备上不起作用。 但是，此方法即使在纯设备上也能使用，因为它会返回接口。

设备现在可以支持多个呈现目标。 设备支持的呈现目标数包含在 D3DCAPS9 的 NumSimultaneousRTs 成员中。 请参阅 Direct3D 9) (多个呈现目标 。

调用此方法会增加 IDirect3DSurface9 接口上的内部引用计数。 使用完 IDirect3DSurface9 接口后无法调用 IUnknown：：Release 会导致内存泄漏。

要求

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

另请参阅

IDirect3DDevice9

IDirect3DDevice9：：SetRenderTarget