IDirect3DDevice9::CreateRenderTarget メソッド (d3d9helper.h)

  • [アーティクル]

レンダー ターゲット サーフェスを作成します。

構文

HRESULT CreateRenderTarget(
  [in]          UINT                Width,
  [in]          UINT                Height,
  [in]          D3DFORMAT           Format,
  [in]          D3DMULTISAMPLE_TYPE MultiSample,
  [in]          DWORD               MultisampleQuality,
  [in]          BOOL                Lockable,
  [out, retval] IDirect3DSurface9   **ppSurface,
  [in]          HANDLE              *pSharedHandle
);

パラメーター

[in] Width

型: UINT

レンダー ターゲット サーフェスの幅 (ピクセル単位)。

[in] Height

型: UINT

レンダー ターゲット サーフェスの高さ (ピクセル単位)。

[in] Format

型: D3DFORMAT

レンダー ターゲットの形式を記述する D3DFORMAT 列挙型のメンバー。

[in] MultiSample

種類: D3DMULTISAMPLE_TYPE

マルチサンプリング バッファー型を記述する、 D3DMULTISAMPLE_TYPE 列挙型のメンバー。 このパラメーターは、このレンダー ターゲットのアンチエイリアシングの種類を指定します。 このサーフェスを IDirect3DDevice9::SetRenderTarget に渡す場合、そのマルチサンプルの種類は 、IDirect3DDevice9::SetDepthStencilSurface によって設定された深度ステンシルの型と同じである必要があります。

[in] MultisampleQuality

型: DWORD

品質レベル。 有効な範囲は、 IDirect3D9::CheckDeviceMultiSampleType によって使用される pQualityLevels によって返されるレベルより 0 から 1 未満の範囲です。 より大きな値を渡すと、エラーが返D3DERR_INVALIDCALL。 ペアのレンダー ターゲット、深度ステンシル サーフェス、マルチサンプルタイプの MultisampleQuality 値はすべて一致している必要があります。

[in] Lockable

種類: BOOL

アプリケーションで Lockable に TRUE を 指定しない限り、レンダー ターゲットはロックできません。

ロック可能なレンダー ターゲットでは、一部のグラフィックス ハードウェアのパフォーマンスが低下します。 読み取り戻しのパフォーマンス (ビデオ メモリからシステム メモリへのデータの移動) は、使用されるハードウェアの種類 (AGP と PCI Express) によって異なり、通常はアップロード パフォーマンス (システムからビデオ メモリへのデータの移動) よりもはるかに低くなります。 レンダー ターゲットに読み取りアクセスが必要な場合は、ロック可能なレンダー ターゲットの代わりに GetRenderTargetData を 使用します。

[out, retval] ppSurface

種類: IDirect3DSurface9**

IDirect3DSurface9 インターフェイスへのポインターのアドレス。

[in] pSharedHandle

型: HANDLE*

予約済み。 このパラメーターを NULL に設定 します。 このパラメーターは、Windows Vista 用 Direct3D 9 で リソースを共有するために使用できます。

戻り値

型: HRESULT

メソッドが成功した場合、戻り値はD3D_OK。 メソッドが失敗した場合、戻り値は次のいずれかになります:D3DERR_NOTAVAILABLE、D3DERR_INVALIDCALL、D3DERR_OUTOFVIDEOMEMORY、E_OUTOFMEMORY。

解説

レンダー ターゲット サーフェスは、D3DPOOL_DEFAULT メモリ クラスに配置されます。

ロック可能なマルチサンプリング レンダー ターゲットの作成はサポートされていません。

要件

   
対象プラットフォーム Windows
ヘッダー d3d9helper.h (D3D9.h を含む)
Library D3D9.lib

関連項目

IDirect3DDevice9