IDirect3DDevice9::GetRenderTarget
レンダー ターゲット サーフェスを取得します。
HRESULT
GetRenderTarget(
DWORD RenderTargetIndex,
IDirect3DSurface9 ** ppRenderTarget
);
パラメータ
- RenderTargetIndex
レンダー ターゲットのインデックス。「解説」を参照してください。 - ppRenderTarget
取得するこのデバイスのレンダー ターゲット サーフェスを表す IDirect3DSurface9 インターフェイスへのポインターのアドレスです。
戻り値
メソッドが成功した場合は、D3D_OK を返します。メソッドが失敗した場合、いずれかの引数が無効である場合は D3DERR_NOTFOUND を、指定されたインデックスに使えるレンダー ターゲットがなかった場合は D3DERR_NOTFOUND を返します。
解説
通常、ステートを返すメソッドは、D3DCREATE_PUREDEVICE を使って作成されたデバイスで動作しません。ただし、このメソッドはインターフェイスを返すため、ピュア デバイスでも機能します。
現在、デバイスは複数のレンダー ターゲットをサポートできます。デバイスでサポートされるレンダー ターゲットの数は、D3DCAPS9 の NumSimultaneousRTs メンバーに含まれています。「複数のレンダー ターゲット (Direct3D 9)」を参照してください。
このメソッドを呼び出した後は、IDirect3DSurface9 インターフェイスの内部リファレンス カウントが増加します。IDirect3DSurface9 インターフェイスの使用を終了したときに IUnknown::Release を呼び出さないと、メモリー リークが発生します。
要件
ヘッダー: D3D9.h 宣言
ライブラリ: D3D9.lib 内容