Microsoft DirectX 8.0 (C++)

IDirect3DDevice8::CreateRenderTarget

レンダリング ターゲット サーフェスを作成する。

HRESULT CreateRenderTarget(
  UINT Width,
  UINT Height,
  D3DFORMAT Format,
  D3DMULTISAMPLE_TYPE MultiSample,
  BOOL Lockable,
  IDirect3DSurface8** ppSurface
);

パラメータ

Width
[in] レンダリング ターゲット サーフェスの幅 (ピクセル単位)。
Height
[in] レンダリング ターゲット サーフェスの高さ (ピクセル単位)。
Format
[in] D3DFORMAT 列挙型のメンバ。レンダリング ターゲットのフォーマットを示す。
MultiSample
[in] マルチサンプリング バッファ タイプを記述する D3DMULTISAMPLE_TYPE 列挙型のメンバ。このパラメータは、作成するレンダリング ターゲットのアンチエイリアシング タイプを指定するものである。このタイプは、両方のバッファを SetRenderTarget に渡すときの深度ステンシル バッファのものと同じでなければならない。
Lockable
[in] アプリケーションが Lockable に TRUE を指定しない限り、レンダリング ターゲットはロックできない。ロック可能なレンダリング ターゲットによって、一部のグラフィック ハードウェアではパフォーマンスのコストが向上することに注意すること。
ppSurface
[out, retval] IDirect3DSurface8 インターフェイスへのポインタのアドレス。

戻り値

成功した場合は、D3D_OK を返す。

失敗した場合は、次のいずれかの値を返す。

D3DERR_INVALIDCALL
D3DERR_OUTOFVIDEOMEMORY
E_OUTOFMEMORY

注意

レンダリング ターゲット サーフェスは、D3DPOOL_DEFAULT メモリ クラスに格納される。

動作環境

  ヘッダー : d3d8.h で宣言。
  インポート ライブラリ : D3d8.lib を使用。