IDirect3DDevice9：：GetRenderTarget 方法 (d3d9helper.h)

擷取轉譯目標表面。

語法

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

[in] RenderTargetIndex

類型： DWORD

轉譯目標的索引。請參閱＜備註＞。

[out] ppRenderTarget

IDirect3DSurface9 介面指標的位址，代表此裝置傳回的轉譯目標表面。

類型： HRESULT

如果方法成功，傳回值會D3D_OK。如果方法失敗，如果其中一個自變數無效，則可以D3DERR_INVALIDCALL傳回值，或者如果指定的索引沒有可用的轉譯目標，則D3DERR_NOTFOUND。

通常，傳回狀態的方法無法在使用 D3DCREATE_PUREDEVICE 建立的裝置上運作。不過，此方法即使在純裝置上仍可運作，因為它會傳回介面。

裝置現在可以支援多個轉譯目標。裝置支援的轉譯目標數目包含在 D3DCAPS9 的 NumSimultaneousRTs 成員中。請參閱 (Direct3D 9) 的多個轉譯目標。

呼叫這個方法將會增加 IDirect3DSurface9 介面上的內部參考計數。使用 IDirect3DSurface9 介面完成時，無法呼叫 IUnknown：：Release 會導致記憶體流失。