IDirect3DDevice9::GetRenderTarget メソッド (d3d9.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 を呼び出さなかった場合、メモリリークが発生します。