Share via

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